Documentation Systems
The delivered application contains a replaceable customer help center, while the repository documentation explains how owners and maintainers build and operate the product.
On this page
Two documentation systems
| System | Audience | Maintainer reference | Publishing model |
|---|---|---|---|
| Customer help center | People who use your finished product. | Implementation referencesrc/features/docs/shared/content.ts and src/features/docs/ui. | Ships at /docs inside your application; replace the starter content with workflows and support information for your own users. |
| Owner and maintainer guide | People who customize, deploy, and operate the codebase. | The repository docs directory plus README, AGENTS.md, SECURITY.md, SUPPORT.md, and LICENSE. | Read with the source checkout; changes do not automatically publish to the customer help center. |
Implementation reference3 areas
These Product code locations explain how the documented behavior is implemented. Expand them when you are ready to customize or maintain this area.
Content contract
Stable section identifiers and typed blocks define the replaceable starter content.
src/features/docs/shared/content.tssrc/features/docs/shared/types.ts
Explorer UI
Navigation, filtering, rendering, and block presentation form the in-product documentation experience.
src/features/docs/ui/explorer.tsxsrc/features/docs/ui/navigation.tsxsrc/features/docs/ui/blocks.tsx
Route entrypoint
The public /docs route delegates rendering to the feature UI.
src/app/docs/page.tsxsrc/features/docs/ui/page.tsx
Reference paths are relative to the Shipflash-Product checkout.
Maintainer guide map
| File | Use |
|---|---|
| docs/getting-started/launch.md | Production launch checklist. |
| docs/deploy/deployment.md | Deployment guide and host capability notes. |
| docs/extend/customization.md | Branding, UI, and copy customization guide. |
| docs/extend/development.md | Feature development workflow rules. |
| docs/extend/architecture.md | Platform architecture boundary guidelines. |
| docs/extend/module-removal.md | Safe module removal checklist. |
| docs/extend/testing.md | Testing guidelines and layers. |
| docs/operate/operations.md | Production operations, incident response, recovery, retention, and scheduled jobs. |
| docs/product/billing/setup.md | Stripe and Lemon Squeezy integration guides. |
| docs/product/notifications/email/setup.md | Supabase Auth and Resend transactional email configuration. |
Update documentation in the same change when you
- Add, rename, or remove an environment variable, route, role, table, RPC, storage bucket, job, webhook, event, or command.
- Change a provider setup step, capability, payload, dashboard setting, or test-mode procedure.
- Change a customer workflow, module boundary, failure mode, support process, or removal path.
- Add a migration, backfill, repair, retention rule, backup requirement, or recovery step that operators must understand.
- Change the product behavior represented in your published customer help center.