research-presentation-template: Instructions file for Claude Code

CLAUDE.md — authoring this deck

You are helping build a research talk. This repo is a fixed-canvas React deck: every slide is a component authored against a 1280×720 stage that scales to any projector. Read this before writing a slide.

AGENTS.md points here; both files describe the same rules.

The three things people get wrong

1. Too much on one slide. A slide is one idea. If it needs a paragraph, it's two slides. The OverflowGuard will scream (red badge, dev only) when content spills past the canvas — that's a design signal, not a bug to suppress by shrinking type.
2. Type too small. Body text ≥ 22px, bullets ~34px, slide titles ~46px, big claims 54–92px. The canvas is 1280 wide, so 22px here reads like 14pt in PowerPoint — from the back of a lecture hall that's already the floor.
3. Editing the wrong file. Title, authors, venue, links, theme, social card: all in presentation.config.json. Never hard-code them in a slide.

Where things live

presentation.config.json   the only file to edit per talk
src/config.ts              typed view of it
src/themes/index.ts        THEMES — token sets (dark + light per theme)
src/ThemeContext.tsx       useTheme() -> { T, glow, mode, name }
src/deck/                  Deck, SlideShell, PrintMode, Settings, Backdrop, OverflowGuard
src/primitives/            Panel Chip Bullet Accent Stat Figure Quote Rise Stagger CodeBlock
src/slides/                one file per slide + index.ts (the deck order)
scripts/export-deck.mjs    PPTX + PDF capture
scripts/make_og.py         social card
examples/                  a real, complete talk you can run and copy from

Adding a slide

1. Create src/slides/NN_Name.tsx exporting one component.
2. Add one line to the slides array in src/slides/index.ts.
3. Section numbers derive themselves — never hard-code a kicker number. Set bare: true for title / divider / closing slides so they don't consume one.

A content slide is always SlideShell + absolutely-positioned content: