Make software by describing it

How to Test a Small Tool Before You Share It

To test a small tool before you share it, run it with inputs where you already know the answer, try unusual inputs, check it on a phone and another browser, and have someone else use it without your help. An hour of this finds most problems that visitors would hit in the first week. AI-written code often looks right while failing on cases the assistant did not consider, so the testing is your job, not the assistant’s.

None of this needs technical knowledge. It needs patience and a written list.

Write the test list first

Before you click anything, list what the tool should do. Turn each behavior into a check with an expected result. For a unit converter:

Writing expectations before testing keeps you honest. If you only look at results afterward, it is easy to decide that whatever you see is probably fine.

Test with known answers

For tools that calculate, choose inputs whose results you can verify independently. Use a calculator, a reference table or a hand calculation. Check at least three ordinary cases and compare digit by digit, including rounding.

If the tool uses a formula or factor that you cannot verify yourself, check it against an authoritative source such as an official table or documentation. Do not assume the assistant is right because it sounds sure. Confident wording is not evidence.

Test the edges

Bugs gather at the edges. Try:

  1. Nothing at all in each field.
  2. Zero.
  3. Negative numbers.
  4. Very large numbers, and numbers with many decimals.
  5. Letters, symbols and emoji where numbers belong.
  6. Very long text.
  7. Clicking a button many times quickly.
  8. Pressing the browser’s back button, then going forward.
  9. Reloading in the middle of a task.

You are looking for crashes, strange outputs like NaN or undefined, frozen buttons and anything that looks broken. Decide what the right behavior is for each case, and report mismatches to your assistant with the exact input.

Test on different devices and browsers

A tool that works in one place may fail in another. At minimum, check:

Look at layout, text size, tap targets and any feature that depends on the browser, such as sound, saving data or file downloads. If you do not own several devices, ask a friend to open the link on theirs and send you a screenshot.

Check what happens offline and slow

If your tool loads files from the internet, such as libraries or fonts, turn off your connection and reload. See what the visitor sees. Does the tool show a helpful message, or just a blank page? Then use your browser’s throttling option in developer tools to simulate a slow connection and observe loading.

Watch someone else use it

You know how the tool is supposed to work, so you will avoid its problems without noticing. Give the link to someone who has not seen it, and watch them use it without helping. Take notes on where they hesitate, what they click that does nothing and what they misunderstand. Do not defend the design while they are using it; just observe.

Even one person turns up issues you cannot see yourself. Ask them afterward what they expected to happen at the points where they paused.

Read the console

Open the browser console while you test. Errors and warnings there can reveal problems that are invisible on screen. Fix the errors you can, and paste the rest to your assistant for explanation.

Record and fix

Keep a list of failures with the steps to reproduce each. Fix them one by one, retesting the whole list after each fix, since fixes can introduce new problems. Mark each item as passed with the date. Keep the list for next time, and expand it each time a real bug appears.

Know what you cannot test

Some risks are beyond a quick test: legal compliance, security under attack and behavior under heavy traffic. If your tool handles personal data or money, get a review from someone qualified before sharing widely, and be clear about its limits with your visitors.

Re-test after every change

Testing is not a one-time event. Every edit, even a small one, can break something. After each change, run at least the short version of your list: the main calculation, one edge case, a reload and a phone check. Mark the date in your log.

Before a major update, run the full list. It feels repetitive, but repetition is the point. The most embarrassing bugs in published tools are usually in features that worked last month and broke quietly when something nearby changed. A written list, run consistently, is the cheapest protection you have, and it works the same way whether your tool has ten lines or ten thousand.

If you share the tool with people you do not know, add a short line on the page about what it is for and what it is not for. A converter that is accurate for everyday use may not be suitable for professional or safety-related work, and saying so plainly protects both you and your visitors. Honest limits build more trust than silence, and they are easy to add once you know where the tool is reliable.

Next steps

Write a test list for a tool you have built and run it today, including at least five edge cases and one phone check. Ask one person to try it without your help. Fix what you find, save a version and note the date of the last full test in your log.