Skip to content

How to Edit FAQs

FAQs on the marketing page are driven by a single markdown file. No code changes needed.

Edit

Open apps/web/content/faqs.md and add, remove, or reorder entries. Format:

## Your question here?
Your answer here. Plain text, one or more paragraphs.
## Another question?
Another answer.
  • Each ## heading becomes the question
  • Everything between headings becomes the answer
  • Lines above the first ## are ignored (used for editing notes)
  • Order in the file = order on the page

Deploy

The build script (scripts/generate-faqs.mjs) converts the markdown to a TypeScript data file automatically. Just deploy as normal:

Terminal window
cd apps/web && npm run build

The FAQ section, including the JSON-LD structured data for SEO, updates automatically.

Local preview

Terminal window
cd apps/web
node scripts/generate-faqs.mjs # regenerate data file
npm run dev # start dev server

File locations

FilePurpose
apps/web/content/faqs.mdSource of truth — edit this
apps/web/scripts/generate-faqs.mjsBuild script that parses markdown → TypeScript
apps/web/src/data/faqs.tsAuto-generated, gitignored — do not edit
apps/web/src/app/(marketing)/page.tsxFAQ component that imports the generated data