---
title: Developer Onboarding
section: ops
summary: Quick start steps to clone, install dependencies, and generate the site locally.
tags: [onboarding, setup]
nav: 1
---

# Developer Onboarding

1. Clone the repository and install Node 20+.
2. Run `npm install` to pull dependencies.
3. Build with `npm run build`; output lands in `dist/`.
4. Serve `dist/` via any static server (e.g., `npx serve dist`).

## Directory overview
- `content/`: Markdown notes with front matter.
- `templates/`: HTML shells for header, footer, and layout.
- `assets/`: CSS and JavaScript shared across pages.

## Conventions
- Use kebab-case filenames.
- Keep summaries short; they populate listings and the search index.
- Add tags to improve search results.