How we structure marketing pages

Marketing pages and blog posts have different jobs.

Pages stay in code

Landing pages often need custom layout, motion, and conversion-focused sections. Those remain React routes under src/app/(marketing)/ so designers and engineers can compose them freely.

Posts live as MDX

Long-form content benefits from a document model. Each post is an MDX file with YAML frontmatter for title, summary, publish date, author, tags, and draft state.

Checklist for a new post

1. Add a .mdx file under content/posts/
2. Fill in the frontmatter — title, summary, date, author, tags
3. Write the body in MDX
4. Leave draft: true while drafting; set it to false to publish

Tip: keep URLs stable. The filename becomes the slug in /blogs/[slug] and future redirects from the live site.