# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## What this is

A Marp-based presentation system. Source files are `.md` with Marp frontmatter. Outputs are HTML and PDF.

## Build

```bash
./build.sh <file.md>          # builds both HTML and PDF
./build.sh <file.md> html     # HTML only
./build.sh <file.md> pdf      # PDF only
```

Requires Node/npx — Marp CLI is pulled via `npx @marp-team/marp-cli@latest`.

## Theme

Custom Marp theme named `upshift` — source in `upshift-theme.css`, authoring reference in [`THEME.md`](./THEME.md). Read `THEME.md` before writing new slides or adding new slide classes — it covers the full class vocabulary, per-class markdown contracts, modifiers, and the authoring checklist.

Brand colors: accent orange `#E8612A`, dark background `#0D1117`. Fonts are local woff2 files in `fonts/` — presentations render correctly offline.

## Assets

- `images/` — photo backgrounds used in full-bleed slides
- `fonts/` — Manrope and Fraunces (local, offline-capable)
- `logo.svg` — injected into HTML output via `sed` in `build.sh`
