This site is a Markdoc instance: Markdown with a typed, validated tag syntax, compiled by Next.js into a fully static bundle and served from S3 behind CloudFront.
Where to start#
- Getting started — run it locally.
- Authoring with Markdoc — pages, frontmatter, tags.
- Infrastructure & deploys — the AWS stack and the GitHub Actions pipeline.
How it fits together#
| Layer | What it is |
|---|---|
| Content | .md files under pages/, compiled by @markdoc/next.js |
| Schema | markdoc/tags/ and markdoc/nodes/, enforced by pnpm validate:content |
| Build | next build with output: "export" → a static out/ |
| Hosting | Private S3 bucket, read by CloudFront through an Origin Access Control |
| Delivery | GitHub Actions assumes an AWS role via OIDC, syncs out/, invalidates the edge |