ftsfn dev

about

what this site is and how it is put together

this is the docs half of dev.ftsfn.net, the posts live on the front page and these pages cover how the site itself works

how it is built

  • fumadocs on next, exported as plain static files, output: "export" in next.config.mjs
  • the source lives in dev/ of the server repo, a push that touches it runs .github/workflows/deploy-dev.yml, which builds it and force pushes the export to the deploy-dev branch
  • the vps pulls that branch within a minute (vps/sites/dev.env), so nothing builds on the box
  • search is a static orama index built at export time, covering the docs and the posts

running it locally

cd dev
npm ci
npm run dev       # http://localhost:3000, drafts show here
npm run build     # the real export into out/, drafts left out

see writing posts for the frontmatter

On this page