Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.
Specifications is coming soon. This documentation previews what the section will look like at launch.
A specification is a structured description of a feature’s behavior, written in plain language. It lives between the plan and the code, providing the detail that determines exactly what the build produces.
Anatomy of a specification
Each feature in your plan generates a specification with five sections:
Screens
The user-facing surfaces for this feature. Each screen has a purpose, a list of elements (text, inputs, buttons, lists), and the actions available on it. Specifications do not specify pixels — they specify what is on screen and what the user can do with it. Visual styling lives in the Frontend theming layer.
Flows
A flow is a sequence: the user does X, then Y happens, then they see Z. Flows connect screens. They include success paths, alternate paths, and error paths. Each flow names the actor (which user type), the trigger, and the outcome.
Behaviors
The non-flow logic. What gets calculated, what runs on a schedule, what fires on an event, what auto-saves. Behaviors are usually one or two sentences each — “when an order’s total exceeds $500, flag it for manual review.”
Validation and edge cases
Required fields, format rules, business rules (“a user cannot order more than 10 of an item”), and edge cases (empty states, network failures, concurrent edits, large datasets). The specification is the place where you say what should happen in each case.
Copy
Exact text for labels, buttons, placeholders, helper text, success messages, error messages, and empty states. Specifying copy upfront avoids two rounds of “the button text is wrong” after the build.
How specs relate to plans
The plan says what your app does. Specifications say how each thing behaves. A plan module called “Orders” might generate a specification covering the order list screen, the order detail screen, the create-order flow, the cancel-order flow, the validation rules for each, and the copy throughout.When you change the plan (add a module, drop a service), the affected specifications regenerate. When you edit a specification directly, the plan stays the same — you are refining the detail, not the structure.
How specs relate to code
Specifications are the contract for what the build produces. Each spec section maps to generated code: screens become routes and components, flows become page transitions and form handlers, behaviors become functions, validation becomes form rules and database constraints, copy becomes localization strings. See Specifications and code generation.
Where specifications come from
Archie generates an initial specification for every feature in your plan. You edit it the same way you edit plan sections — directly, or through the spec chat for multi-step changes. See Editing specifications.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Archie Documentation","description":"Official docs for Archie, the AI full-stack app builder that generates a plan before code, then builds a production app with database, APIs, and auth.","colors":{"primary":"#D83F37","light":"#E5564E","dark":"#D83F37"},"logo":{"light":"https://mintcdn.com/archie-e998dbf6/GqLKywMFdSdVW_pv/logo/light.svg?fit=max\u0026auto=format\u0026n=GqLKywMFdSdVW_pv\u0026q=85\u0026s=49b1cf2b436e3a5eff7c748509d1917d","dark":"https://mintcdn.com/archie-e998dbf6/GqLKywMFdSdVW_pv/logo/dark.svg?fit=max\u0026auto=format\u0026n=GqLKywMFdSdVW_pv\u0026q=85\u0026s=9523970431196f662bbf2683848a003c","href":"https://archie.com"},"favicon":"https://mintcdn.com/archie-e998dbf6/RPVhI0P2wHtDBThL/favicon.svg?fit=max\u0026auto=format\u0026n=RPVhI0P2wHtDBThL\u0026q=85\u0026s=f8e10796de983605886f4b3849e52906","appearance":{"default":"system"},"background":{"color":{"light":"#FFFFFF","dark":"#0B1222"}},"navbar":{"links":[],"primary":{"type":"button","label":"Try Archie","href":"https://app.archie.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/archie","discord":"https://discord.gg/EwKqQH5TQU","x":"https://x.com/archieforall"}},"seo":{"metatags":{"canonical":"https://www.archie.com/docs","google-site-verification":"_ZBDHd_5eIme25_0XMw5WgvMBWZuxl0Q7uK8JlKHjtU","msapplication-TileImage":"/favicon.png","author":"Archie","robots":"index, follow","googlebot":"index, follow","theme-color":"#000000","color-scheme":"dark light","og:site_name":"Archie","og:type":"website","og:locale":"en_US","application-name":"Archie","apple-mobile-web-app-title":"Archie","msapplication-TileColor":"#000000","twitter:card":"summary_large_image"},"indexing":"all"},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"integrations":{"ga4":{"measurementId":"G-KV3V08P4B3"},"gtm":{"tagId":"GT-MBNKS363"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"background":"https://mintcdn.com/archie-e998dbf6/jqktZCSfULHmVt_E/images/background.svg?fit=max\u0026auto=format\u0026n=jqktZCSfULHmVt_E\u0026q=85\u0026s=70c7e97571adf55d031d7660d5b24e6e","fonts":{"family":"Geist"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"archie-e998dbf6","hasAudioNarration":false,"actualSubdomain":"archie-e998dbf6","customDomains":["archie.com"],"gitSource":{"type":"github","owner":"8base-archie","repo":"archie.com-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b008a4ad380267e8a2d3e59","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":172},{"language":"default","tag":"Build","count":147},{"language":"default","tag":"Backend","count":104},{"language":"default","tag":"App services","count":33},{"language":"default","tag":"Frontend","count":33},{"language":"default","tag":"Data","count":21},{"language":"default","tag":"Specifications","count":20},{"language":"default","tag":"Prototype","count":14},{"language":"default","tag":"Authentication Providers","count":11},{"language":"default","tag":"Fields","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"html:root{--gray-50: 240 242 245;--gray-100: 232 234 238;--gray-200: 223 226 231;--gray-300: 198 203 210;--gray-400: 154 161 172;--gray-500: 104 111 125;--gray-600: 74 82 94;--gray-700: 49 55 63;--gray-800: 34 42 52;--gray-900: 27 33 45;--gray-950: 11 18 34}[data-testid=\"theme-preference-menu-trigger\"]{display:none!important}.archie-theme-toggle{display:inline-flex;align-items:center;justify-content:center;width:2rem;height:2rem;border-radius:0.375rem;color:#222a34;cursor:pointer;transition:background-color 0.2s, color 0.2s}.archie-theme-toggle:hover{background-color:#f2f4f7}.archie-theme-toggle:focus-visible{outline:2px solid #d83f37;outline-offset:2px}.archie-theme-toggle svg{width:18px;height:18px;transition:transform 0.3s}.archie-theme-toggle:hover svg{transform:rotate(-15deg)}.archie-theme-toggle__sun,html.dark .archie-theme-toggle__moon{display:none}html.dark .archie-theme-toggle__sun{display:block}html.dark .archie-theme-toggle{color:#f3f4f6}html.dark .archie-theme-toggle:hover{background-color:#1a2333}"}]}
{"page":{"pagePath":"features/specifications/what-are-specifications","slug":"/features/specifications/what-are-specifications","pageMetadata":{"title":"What are specifications","description":"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.","href":"/features/specifications/what-are-specifications","hidden":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,em:`em`,p:`p`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:`Specifications is coming soon. This documentation previews what the section will look like at launch.`}),`\n`,_jsx(_components.p,{children:`A specification is a structured description of a feature’s behavior, written in plain language. It lives between the plan and the code, providing the detail that determines exactly what the build produces.`}),`\n`,_jsx(Heading,{level:`2`,id:`anatomy-of-a-specification`,children:`Anatomy of a specification`}),`\n`,_jsx(_components.p,{children:`Each feature in your plan generates a specification with five sections:`}),`\n`,_jsx(Heading,{level:`3`,id:`screens`,children:`Screens`}),`\n`,_jsxs(_components.p,{children:[`The user-facing surfaces for this feature. Each screen has a purpose, a list of elements (text, inputs, buttons, lists), and the actions available on it. Specifications do not specify pixels — they specify what is on screen and what the user can do with it. Visual styling lives in the `,_jsx(_components.a,{href:`/features/frontend/theming`,children:`Frontend theming`}),` layer.`]}),`\n`,_jsx(Heading,{level:`3`,id:`flows`,children:`Flows`}),`\n`,_jsx(_components.p,{children:`A flow is a sequence: the user does X, then Y happens, then they see Z. Flows connect screens. They include success paths, alternate paths, and error paths. Each flow names the actor (which user type), the trigger, and the outcome.`}),`\n`,_jsx(Heading,{level:`3`,id:`behaviors`,children:`Behaviors`}),`\n`,_jsx(_components.p,{children:`The non-flow logic. What gets calculated, what runs on a schedule, what fires on an event, what auto-saves. Behaviors are usually one or two sentences each — “when an order’s total exceeds $500, flag it for manual review.”`}),`\n`,_jsx(Heading,{level:`3`,id:`validation-and-edge-cases`,children:`Validation and edge cases`}),`\n`,_jsx(_components.p,{children:`Required fields, format rules, business rules (“a user cannot order more than 10 of an item”), and edge cases (empty states, network failures, concurrent edits, large datasets). The specification is the place where you say what should happen in each case.`}),`\n`,_jsx(Heading,{level:`3`,id:`copy`,children:`Copy`}),`\n`,_jsx(_components.p,{children:`Exact text for labels, buttons, placeholders, helper text, success messages, error messages, and empty states. Specifying copy upfront avoids two rounds of “the button text is wrong” after the build.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-specs-relate-to-plans`,children:`How specs relate to plans`}),`\n`,_jsxs(_components.p,{children:[`The plan says `,_jsx(_components.em,{children:`what`}),` your app does. Specifications say `,_jsx(_components.em,{children:`how each thing behaves`}),`. A plan module called “Orders” might generate a specification covering the order list screen, the order detail screen, the create-order flow, the cancel-order flow, the validation rules for each, and the copy throughout.`]}),`\n`,_jsx(_components.p,{children:`When you change the plan (add a module, drop a service), the affected specifications regenerate. When you edit a specification directly, the plan stays the same — you are refining the detail, not the structure.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-specs-relate-to-code`,children:`How specs relate to code`}),`\n`,_jsxs(_components.p,{children:[`Specifications are the contract for what the build produces. Each spec section maps to generated code: screens become routes and components, flows become page transitions and form handlers, behaviors become functions, validation becomes form rules and database constraints, copy becomes localization strings. See `,_jsx(_components.a,{href:`/features/specifications/specifications-and-code-generation`,children:`Specifications and code generation`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`where-specifications-come-from`,children:`Where specifications come from`}),`\n`,_jsxs(_components.p,{children:[`Archie generates an initial specification for every feature in your plan. You edit it the same way you edit plan sections — directly, or through the spec chat for multi-step changes. See `,_jsx(_components.a,{href:`/features/specifications/editing-specifications`,children:`Editing specifications`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"What are specifications","description":"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.","href":"/features/specifications/what-are-specifications","hidden":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Anatomy of a specification","slug":"anatomy-of-a-specification","depth":2,"children":[{"title":"Screens","slug":"screens","depth":3,"children":[]},{"title":"Flows","slug":"flows","depth":3,"children":[]},{"title":"Behaviors","slug":"behaviors","depth":3,"children":[]},{"title":"Validation and edge cases","slug":"validation-and-edge-cases","depth":3,"children":[]},{"title":"Copy","slug":"copy","depth":3,"children":[]}]},{"title":"How specs relate to plans","slug":"how-specs-relate-to-plans","depth":2,"children":[]},{"title":"How specs relate to code","slug":"how-specs-relate-to-code","depth":2,"children":[]},{"title":"Where specifications come from","slug":"where-specifications-come-from","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/archie-e998dbf6/229d292c895cde91/theme-toggle.js"],"subdomain":"archie-e998dbf6","siteName":"Archie Documentation","title":"What are specifications - Archie Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T05:03:09.856Z","originalFileLocation":"features/specifications/what-are-specifications.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Archie Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"What are specifications - Archie Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Archie\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.archie.com/docs/features/specifications/what-are-specifications\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://archie-e998dbf6.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=What+are+specifications\u0026amp;description=Specifications+describe+each+feature%2C+screen%2C+and+flow+in+detail+before+any+code+is+written+%E2%80%94+the+layer+between+plan+and+code.\u0026amp;theme=d61ee96343317418f7859b8d\u0026amp;signature=40787ae88a33ad70b910539ab670d6034b3cfbea7f18520793276938c9031cc5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"What are specifications - Archie Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://archie-e998dbf6.mintlify.site/docs/_mintlify/api/og/v2?division=Documentation\u0026amp;title=What+are+specifications\u0026amp;description=Specifications+describe+each+feature%2C+screen%2C+and+flow+in+detail+before+any+code+is+written+%E2%80%94+the+layer+between+plan+and+code.\u0026amp;theme=d61ee96343317418f7859b8d\u0026amp;signature=40787ae88a33ad70b910539ab670d6034b3cfbea7f18520793276938c9031cc5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/archie-e998dbf6/FfbIRCkTWLM1-S2M/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Archie\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"_ZBDHd_5eIme25_0XMw5WgvMBWZuxl0Q7uK8JlKHjtU\">\u003cmeta data-mint-head name=\"msapplication-TileImage\" content=\"/favicon.png\">\u003cmeta data-mint-head name=\"author\" content=\"Archie\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#000000\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"dark light\">\u003cmeta data-mint-head name=\"application-name\" content=\"Archie\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.archie.com/docs/features/specifications/what-are-specifications\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/features/specifications/what-are-specifications.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.archie.com/#organization\",\"name\":\"Archie Documentation\",\"url\":\"https://www.archie.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/archie-e998dbf6/GqLKywMFdSdVW_pv/logo/light.svg?fit=max\u0026auto=format\u0026n=GqLKywMFdSdVW_pv\u0026q=85\u0026s=49b1cf2b436e3a5eff7c748509d1917d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.archie.com/docs#website\",\"name\":\"Archie Documentation\",\"url\":\"https://www.archie.com/docs\",\"publisher\":{\"@id\":\"https://www.archie.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.archie.com/docs/features/specifications/what-are-specifications#webpage\",\"url\":\"https://www.archie.com/docs/features/specifications/what-are-specifications\",\"name\":\"What are specifications\",\"description\":\"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.\",\"dateModified\":\"2026-09-23T05:03:09.856Z\",\"isPartOf\":{\"@id\":\"https://www.archie.com/docs#website\"}},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://www.archie.com/docs/features/specifications/what-are-specifications#article\",\"headline\":\"What are specifications\",\"name\":\"What are specifications\",\"description\":\"Specifications describe each feature, screen, and flow in detail before any code is written — the layer between plan and code.\",\"url\":\"https://www.archie.com/docs/features/specifications/what-are-specifications\",\"mainEntityOfPage\":{\"@id\":\"https://www.archie.com/docs/features/specifications/what-are-specifications#webpage\"},\"dateModified\":\"2026-09-23T05:03:09.856Z\",\"publisher\":{\"@id\":\"https://www.archie.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.archie.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Archie Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Archie Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/features/specifications/what-are-specifications.md","siteName":"Archie Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq/getting-started"}]},{"tab":"Alternatives","pages":[{"title":"Alternatives","href":"/alternatives"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026-11-17"}]},{"tab":"Specifications","icon":"list-tree","hidden":true,"pages":[{"title":"Overview","description":"Specifications are the detailed documents Archie generates from your plan — three design groups that the build agents read before writing any code.","href":"/features/specifications/overview"},{"title":"What are specifications","href":"/features/specifications/what-are-specifications"},{"title":"Generating specifications","description":"How Archie generates detailed specifications from your approved plan — the workflow from plan to per-feature spec.","href":"/features/specifications/generating-specifications"},{"title":"Editing specifications","description":"Refine specifications in plain language — add constraints, refine behavior, mark edge cases, and edit copy directly.","href":"/features/specifications/editing-specifications"},{"title":"Specifications and code generation","description":"How specifications drive code generation — the whole spec set feeds Frontend-Only, Backend-Only, or Full-Stack generation in one pass.","href":"/features/specifications/specifications-and-code-generation"},{"title":"Best practices for specifications","description":"How to write specifications that produce good code — what to include, what to leave out, when to be precise vs. vague.","href":"/features/specifications/best-practices"},{"group":"Functional Design","pages":[{"title":"Overview","description":"Functional Design defines what the app does and who does it — archetype, user types, features, system services, and system requirements.","href":"/features/specifications/functional-design/overview"},{"title":"Archetype","description":"The foundational shape of your app — solution type, commercialization strategy, and the details of how it generates revenue.","href":"/features/specifications/functional-design/archetype"},{"title":"User Types","description":"The personas who use your app and the use cases each one performs — the source of truth for permissions and feature access.","href":"/features/specifications/functional-design/user-types"},{"title":"Features","description":"Modules and the features inside them — each feature has user stories, business rules, and acceptance criteria that drive code generation.","href":"/features/specifications/functional-design/features"},{"title":"System Services","description":"Foundational capabilities your app needs — auth, payments, notifications, file storage, audit logs, and multi-language support.","href":"/features/specifications/functional-design/system-services"},{"title":"System Requirements","description":"Non-functional requirements your app needs to meet — regional, compliance, security, performance, and accessibility.","href":"/features/specifications/functional-design/system-requirements"}]},{"group":"Visual Design","pages":[{"title":"Overview","description":"Visual Design defines how your app looks and behaves on screen — brand, design principles, styling, and reusable layout templates.","href":"/features/specifications/visual-design/overview"},{"title":"General","description":"Brand identity and form factors — logos, favicons, and which device sizes the app needs to support.","href":"/features/specifications/visual-design/general"},{"title":"Design Principles","description":"The visual and interaction principles your design and engineering teams should follow when extending or customizing the generated UI.","href":"/features/specifications/visual-design/design-principles"},{"title":"Styling","description":"Theme, typography, UI framework, and iconography — the concrete style tokens Archie applies across the generated frontend.","href":"/features/specifications/visual-design/styling"},{"title":"Layout","description":"Reusable page templates for the major sections of your app — main navigation, authentication, public landing, onboarding, minimal, and custom.","href":"/features/specifications/visual-design/layout"}]},{"group":"Technical Design","pages":[{"title":"Overview","description":"Technical Design covers the engineering plan — strategy, data model, custom functions, and integrations.","href":"/features/specifications/technical-design/overview"},{"title":"Strategy","description":"The Technical Strategy spec — architecture sections plus Mermaid diagrams that document and drive the generated codebase.","href":"/features/specifications/technical-design/strategy"},{"title":"Data Model","description":"The data-model spec — a synchronized view of the tables, relationships, and types defined in your Backend → Data Model.","href":"/features/specifications/technical-design/data-model"}]}]}]},"basePath":"","title":"What are specifications - Archie Documentation","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":[],"chunks":[]}