The specifications brief is the most profitable document of any web project, and it is also the most often neglected. Without it, you start a build with no plan: the provider guesses, you correct along the way, deadlines blow up, the budget drifts, and the result looks nothing like what you had in mind. With it, everyone knows where we are going, what is delivered, and how we validate.
Many executives think writing a brief is the technical provider's job. That is a mistake. The brief expresses YOUR business objectives, so it is up to you to own it, even with help on the technical part. Here is a complete template, section by section, that you can use as is.
1. Context and objectives
Start by saying who you are, what you sell, to whom, and why you want a website now. Above all, set measurable objectives. "Having a beautiful site" is not an objective. "Generate 20 qualified quote requests per month" or "sell 50 products per month online" are.
Distinguish the main objective from secondary ones. A site that wants to do everything does nothing well. If your priority is lead generation, the entire site must converge toward the contact form, and the rest takes second place.
2. Targets and personas
Describe your typical visitors. A professional buyer comparing suppliers does not have the same expectations as an individual buying a product on impulse. Specify their devices: in Senegal, expect an overwhelming majority of mobile, often on slow networks. This shapes the entire design.
3. Sitemap and navigation
List the pages and their hierarchy. A simple diagram is enough:
- Home: promise, proof, call to action.
- Services or Products: one page per major offer.
- About: team, story, values.
- Work or Testimonials: social proof.
- Blog: engine for SEO and authority.
- Contact: form, map, WhatsApp, phone.
Specify the maximum depth: any important information must be reachable in two or three clicks.
4. Features
This is where budgets drift if you are not precise. Clearly distinguish must-have from nice-to-have:
- Contact form with email and WhatsApp notification.
- Floating WhatsApp button.
- Bilingual French and English.
- Blog with categories and search.
- Customer area, online payment, booking: only if truly needed.
For every advanced feature, ask yourself: does it generate revenue or save a cost? If not, defer it to a later phase.
5. Content
Content is the Achilles heel of most projects. Specify who provides what: text, photos, logo, videos. Be honest about your capacity to produce. If you have neither professional text nor photos, include copywriting and a shoot in the project, otherwise the site will stay stuck for months waiting for content that never comes.
6. SEO and performance requirements
Put your technical expectations in writing: target load time under two seconds on mobile, clean tag structure, readable URLs, customizable meta tags, sitemap, structured data. Also list the priority keywords the site must target. SEO is planned at the brief stage, not after launch.
7. Design and brand guidelines
Indicate your colors, your logo, your universe, and give two or three examples of sites you like, explaining why. Specify whether you provide existing brand guidelines or whether they must be created. This avoids endless back-and-forth on matters of taste.
Need a professional website?
Kolonell builds websites that attract clients, optimized for the Sénégalese market. Free quote in 2 minutes.
8. Budget and timeline
Announce a budget range. Hiding your budget is counterproductive: the provider sizes the proposal blindly. Also set a realistic timeline with milestones: mockups, integration, acceptance testing, launch. Generally count six to ten weeks for a polished showcase site.
9. Acceptance criteria
This is the section that protects you. Define precisely how you will validate delivery: the site loads in under two seconds on mobile, all forms work and send notifications correctly, the site displays properly on the main browsers and screen sizes, basic SEO is in place, you have admin access and ownership of the code. Without written acceptance criteria, a delivery can be neither accepted nor refused objectively.
Mini case study: the firm "Diallo & Associates"
This Dakar consulting firm had launched a website project with no brief. After three months and two providers, nothing was delivered, each blaming the other. We restarted from scratch with an eight-page brief.
The exercise took a week, but it unblocked everything: a clear objective of generating appointments, a frozen sitemap, content listed with an owner per block, signed acceptance criteria. The site was delivered in seven weeks, compliant, and generated its first appointments in the very first month. The brief had turned a chaotic project into a controlled build.
Checklist to copy
- Measurable objectives defined and prioritized.
- Personas and target devices described.
- Complete sitemap validated.
- Features sorted must-have / nice-to-have.
- Content owner assigned per block.
- SEO and performance requirements quantified.
- Brand guidelines provided or to be created.
- Budget and timeline with milestones.
- Acceptance criteria written and signed.
- Clause on ownership of code and content.
FAQ
How many pages should a brief be?
For an SME, five to ten pages is plenty. The goal is clarity, not volume. A document that is too long is never read to the end.
Should I pay to have my brief written?
A good provider helps you structure it as part of scoping. But the substance, your business objectives, must come from you: no one knows your activity better than you.
What happens if my needs evolve mid-project?
That is normal. The brief serves precisely as a reference to distinguish what was planned from what is added. Additions are handled via amendments, without blocking the initial project.
Should it include detailed design?
No, the brief sets design intentions and constraints, not the mockups. Mockups are a production step that flows from the brief.
Does the brief replace the contract?
No, but it is often its most important annex. It defines what is owed, and the contract frames the legal and financial conditions.
Let's talk about your project. We structure your brief with you so you start on solid ground. WhatsApp +221 77 596 93 33.
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.

