# CLAUDE.md

Songwhip Web — a Next.js 15 app (Pages Router) for creating universal music links across streaming services. Uses React 19, Redux Toolkit, TypeScript, styled-jsx. Deployed to Vercel with a Cloudflare Edge Worker caching layer.

## Documentation

Before working on any task, consult the relevant docs in `.claude/docs/` (indexed in `.claude/docs/INDEX.md`). These cover architecture, coding standards, component patterns, state management, API client, testing, and all other project conventions.

### Area-specific docs

Some subdirectories have their own README or CLAUDE.md with context specific to that area:

- `edgeWorker/README.md` — Cloudflare Edge Worker caching layer
- `src/components/Icon/README.md` — Icon component usage
- `src/components/Sortable/smooth-dnd/README.md` — Sortable drag-and-drop internals
- `test/cypress/e2e/README.md` — E2E Cypress tests (staging/production)
- `test/cypress/local/README.md` — Local Cypress tests (docker-based)
- `test/cypress/local/CLAUDE.md` — Claude Code guidance for local Cypress
- `test/k6/README.md` — k6 load/performance tests
- `test/playwright/README.md` — Playwright E2E tests