Eleventy 3 + Nunjucks. Source of truth is Markdown under posts/ and pages/, templates under _includes/.
npm run dev — Runs validate, then Eleventy with --serve (day-to-day editing).npm run validate — Nunjucks + frontmatter checks (scripts/validate.mjs, schema in scripts/layout-schema.mjs). Run after layout or post frontmatter changes.npm run build — Validates, then builds to _site/ (same as CI/Vercel expectations).npm run preview — Validate + vercel dev (only when testing vercel.json behavior).| Area | Location |
|---|---|
| Layout shell, inlined CSS/JS bundle | _includes/layouts/base.njk |
| Eleventy config, shortcodes, globals | .eleventy.js |
| Post/page frontmatter contract | scripts/layout-schema.mjs |
| URL redirects | vercel.json |
| Global site data | _data/site.js (hostname, copyright year, licenseUrl for /license/) |
Static assets (referenced as /static/...) |
static/ → copied to _site/static/ |
| Starfield site background | _includes/layouts/base.njk, static/js/starfield-bg.js; implementation static/experiments/starfield/; scoped CSS html.has-starfield-bg in _includes/css/index.css |
Persistent guidance is in .cursor/rules/ (e.g. YouTube handle, posts/layouts, neon headings, CRT scanline photon, starfield, scratch under .cursor/scratch/). Feature tuning is also summarized in README.md.
_site/ — Build output (listed in .gitignore). Deployments build from source.