Back to lab notesBuild notes
Build notes3 min read

The first five minutes are part of the product.

Installation, setup, and permissions shape the first experience. Help someone reach a useful result without asking for blind trust.

Picture a small desktop utility that turns a rehearsal recording into a list of marked moments. A musician wants to find the passage worth practicing again. They have a recording ready and a few minutes before dinner.

The download page sends them to a release folder. The folder contains several similarly named files. One needs another program installed first. The instructions explain that part after the download.

The useful feature is waiting at the end of a scavenger hunt.

That first stretch belongs to the product, even when it happens outside the main window. The installer, the permission request, and the explanation of where the recording goes are all part of deciding whether this is something worth trying.

Start before the first launch

For the hypothetical recording tool, the download page should name the supported systems and point to the right file. If setup requires another component, say so before someone begins. Explain how to remove the utility as plainly as how to install it.

Compatibility claims need actual checks. If a particular system has not been tested, leave that uncertainty visible. A confident download button cannot supply the missing evidence.

Installation should also have a recognizable finish. The person needs to know whether the tool is ready to open, still waiting on a dependency, or unable to continue. “Done” is not a useful message if the next instruction requires a terminal command nobody mentioned.

A command-line tool can have a good first experience too. Give someone one complete example, explain the input it expects, and show where the result will appear. Do not assume that knowing how to run a command means knowing your file conventions.

Ask for the recording, not the whole computer

Once the utility opens, choosing one audio file would be a sensible beginning. Access to an entire media folder would need its own explanation. Microphone permission should belong to a recording feature, if there is one, rather than appearing merely because the app handles audio.

Before processing the selected file, explain whether it stays on the device or goes to a service. Say whether the original will change. Those answers must describe the implementation that exists, not the reassuring one you intend to build later.

Optional connections can wait. Someone trying the basic task should not need to authorize an account integration that only helps with sharing.

This is related to designing a useful empty screen, but the work begins earlier. A welcoming first window cannot repair an unexplained permission request that arrived before it.

End with something they can check

For this example, the first useful result could be one marker that takes the musician back to a chosen moment in the recording. They can listen and confirm that the tool did what they expected.

A completed tour is less convincing. It tells someone they have seen the controls, not that they can use the utility for their own purpose.

Walk through the whole route on a clean setup, without the builder’s saved preferences or installed dependencies. Read the download page, install the tool, decline an optional permission, and try one recording you have permission to use. Note each point where the instructions assume knowledge the person has not received.

Five minutes is not a universal deadline. Some tools need careful setup. The obligation is to make that effort understandable, so someone can spend their attention on the rehearsal rather than guessing which download to open.