Websites11 min read

Writing a Spec Document for a Custom Web Platform (2026)

Mohamed Bah·Fondateur, Kolonell
September 12, 2026
Share:
Writing a Spec Document for a Custom Web Platform (2026)

Writing a Spec Document for a Custom Web Platform (2026)

Websites

The verdict in three sentences

A poorly scoped spec document (SRS) is the number-one cause of budget overruns on a custom web platform: vendors price the uncertainty, and the quote climbs 30 to 50%. By locking in your prioritised user stories (MoSCoW), your non-functional requirements and your acceptance criteria before any consultation, you get comparable quotes and a realistic budget of EUR 60,000 to 120,000. This guide gives the exact structure to hand vendors.

The spec structure that prevents over-quoting

A good spec clearly separates the functional (what the platform does) from the non-functional (how it must behave). MoSCoW prioritisation (Must / Should / Could / Won't) is the most effective tool to contain the budget: it lets you negotiate scope without renegotiating price.

Spec sectionExpected contentImpact on the quote
Context & goalsBusiness problem, target KPIsFrames the ROI
Functional scope30-60 MoSCoW user storiesCuts risk padding by ~30%
User journeys3-5 personas, wireflowsAvoids UX rework
Non-functional reqsPerf, security, uptimeDirectly quotable
IntegrationsThird-party APIs, SSO, ERPEUR 4,000-18,000/connector
Acceptance criteriaAcceptance testsSecures final payment
Timeline & lotsSprints, milestonesSmooths cash flow

A well-written user story follows the format: *As a [role], I want [action] so that [benefit]*, completed by testable acceptance criteria. This level of detail turns a "wide range" estimate into a fixed-price quote.

Non-functional requirements and 2026 framing budget

Non-functional requirements are often forgotten yet account for 20 to 35% of the effort. Here are 2026 ballpark figures for a B2B custom platform in Western Europe.

ItemTypical 2026 requirementIndicative budget
Discovery & detailed specWorkshops + specsEUR 5,000-12,000
MVP (Must have)15-25 user storiesEUR 35,000-60,000
Should have (v1)15-20 user storiesEUR 20,000-40,000
99.5% uptimeMonitoring + redundancyEUR 3,000-8,000
Security & GDPRRBAC, audit logs, registryEUR 4,000-9,000
Integrations (per API)REST + webhooksEUR 4,000-18,000
Acceptance & go-liveTests, trainingEUR 4,000-9,000

A realistic timeline runs over 3 to 4 sprints of 3 weeks for an MVP, i.e. 3 to 5 months including acceptance. Requiring a staging environment separate from production is non-negotiable: that is where you validate acceptance criteria before paying the balance.

Mini case study

Thomas, COO of a logistics SME, wants a route-tracking platform. Without a spec, he receives three quotes of EUR 70,000, 95,000 and 140,000: incomparable. After drafting 42 MoSCoW user stories (22 Must, 12 Should, 8 Could) and setting uptime at 99.5%, he gets three quotes in a band of EUR 78,000 to 92,000. By deferring the 8 "Could" to phase 2, he starts at EUR 64,000 and spreads the rest over the next fiscal year. Scoping saved him the EUR 45,000 gap between the initial quotes.

Need a professional website?

Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.

Prefer a call back?

Leave your WhatsApp number and a Kolonell expert will get back to you within 1 business day. Free, no strings attached.

FAQ

How long does a good spec take to write?

Allow 2 to 4 weeks with 3 to 5 business workshops. A guided discovery costs EUR 5,000 to 12,000 but saves 20 to 40% on the build by removing uncertainty.

Should everything be specified to the pixel?

No. Specify business rules and acceptance criteria; leave detailed UX to mockups. Over-specifying freezes choices that will change; under-specifying inflates quotes.

MoSCoW or a simple priority list?

MoSCoW forces decisions: a documented "Won't have (this time)" is an immediate saving. A list without a "Won't" category leaves everything open and vendors price for the worst case.

How do I guarantee 99.5% uptime in the spec?

Write it as a measurable requirement (monthly uptime, maintenance window, penalties) and require monitoring. 99.5% allows roughly 3.6 hours of downtime per month: fine for an internal tool, insufficient for critical real-time systems.

Is the EUR 60,000-120,000 budget firm?

It is a 2026 ballpark for a medium-complexity custom platform. The firm quote depends on the number of Must user stories, integrations and security requirements.

Let's scope your project. Send us your scope (number of users, integrations, target uptime) and we'll frame an actionable spec with an indicative budget. Detailed quote within 48 h. WhatsApp +221 77 596 93 33.

Tags:#custom platform spec#software requirements document#MoSCoW user stories#web platform scoping#non-functional requirements#development budget#custom web app#2026
Share:

Mohamed Bah

Fondateur, Kolonell

Passionate about digital and entrepreneurship in Africa, Mohamed has been helping Sénégalese businesses with their digital transformation since 2020. Founder of Kolonell, he believes every SME deserves a professional and accessible online présence.