How to write a spec for your app (a one-page template)

You do not need a 40-page document to get a serious quote for an app. You need one page that answers seven questions. I have been pricing projects for twenty-five years, and a clear single page beats a thick requirements binder every time: the binder hides the important decisions, the page forces them.

The seven questions

1. The job, in one sentence. Who does what, and why it matters. "Field technicians close work orders with photo proof so the office stops losing disputes." If the sentence needs three "and also", you are describing two apps. Pick one.

2. The people. Everyone who touches the system, with numbers. One warehouse worker? Three technicians and a coordinator? Numbers decide architecture: one person can live offline on one phone, a team needs a server, and that difference can double the budget.

3. One real scenario, step by step. Take yesterday. Walk through the task as it actually happened: who opened what, entered what, and what had to come out at the end. Write it as a story, not as features. Nine times out of ten this story contains the whole product, and I read it more carefully than any feature list.

4. The data. What is stored (clients, orders, photos, prices) and what of it is confidential. This shapes both the database and the privacy answer, and clients who bring it up front save themselves a week of questions.

5. Offline or online. Where will the app be used: an office with Wi-Fi, or basements, warehouses and country roads? Offline-first is our specialty precisely because so many business apps are used where connectivity is a rumor.

6. What it must talk to. Every existing system the app must exchange data with: accounting software, a bank, an online store, a government API. Name them by name. Integrations are the most underestimated cost driver in app development.

7. What is out of scope. The bravest and most money-saving section. "No user accounts in version one. No iOS until Android proves itself. No admin panel, CSV export is enough." Every honest "no" here shortens the timeline.

"Here is a site I like, build me the same"

This phrasing is a developer's nightmare, and I say that with love. First, studying someone else's product is a separate job: hours of clicking through features that may not even matter to you. Second, I can miss functionality that is obvious to you, because you know that product as a user and I am seeing it for the first time. If you want to repeat something, you are the expert on it: write down the list of features you actually use, and that list becomes part of the spec. A spec that both the client and the developer genuinely understand is more than half of the project's success.

What you can safely leave out

Design: wireframes come later and are part of the work, not a prerequisite. Technology choices: picking the stack is literally what you hire a developer for. Fonts, colors, and the logo animation: version two material, all of it.

The template

  • Job: one sentence.
  • People: roles and headcount.
  • Scenario: yesterday's task, step by step, ten lines.
  • Data: what is stored, what is confidential.
  • Connectivity: where the app is used, offline needs.
  • Integrations: systems by name, or "none".
  • Out of scope: the explicit "no" list.

What happens to your page

Send it through the contact form. We come back with clarifying questions, then with a short written spec of our own: what will be built, for how much, by when. You approve it, and from that moment the price and the date are fixed. The one-page spec is not bureaucracy; it is the cheapest insurance you will ever buy for a software project.

The message that arrives after the spec is signed

It usually looks small and innocent: "oh, and you will add X, right?". From my own practice: at about 70 percent of an accounting system for an advertising production company, the client wrote "you will add two-currency accounting, right? Everyone does that now". That one sentence meant rebuilding the core of the application and every report form in it. Nobody was being difficult; it simply had not come up before.

So this is the rule we work by: any structural change or addition automatically reopens both the price and the deadline. Not as a punishment, as arithmetic. The healthy flow is simple: everything important is discussed and approved before the work starts, and new ideas are collected for the next stage, taken on after the finished work is accepted. Your project stays on schedule, and the new idea gets an honest estimate instead of being squeezed in sideways.

Have a project in mind?

Tell us what you need. We answer most enquiries within two working days, and the scoping conversation is free.

Get in touch