# Dev Notes

Lightweight static notes site built from Markdown with front matter. A small Node-based generator produces HTML ready for Cloudflare Pages.

## Quick start

- Install Node 20+: `npm install`
- Build the site: `npm run build`
- Open `dist/index.html` in a browser or serve via `npx serve dist`

## Content structure

- Write notes in `content/` using kebab-case filenames and front matter (`title`, `section`, `summary`, `tags`, optional `nav`).
- Sections map to directories in the output (`/section-slug/`), and each note becomes `/section-slug/note-slug/`.
- Templates live in `templates/`; shared styles and scripts live in `assets/`.

## Deployment

- The GitHub action `.github/workflows/build.yml` installs dependencies and runs the build.
- Cloudflare Pages can publish the `dist/` directory produced by `npm run build`.