Open Source Breathwork Template
In for four, out for four. That's it. That's the app.
A calm breathing companion: an animated pacer for box, 4-7-8, coherent, and long-exhale patterns, with a private session history.
This is the real app, not a mockup. Whatever you enter in the demo stays in your browser and belongs to nobody.
What you get
One zip. Everything to own it.
Breathwork is deliberately the smallest app in the library: pick a pattern, pick a length, press Begin, and follow the circle. Phase cues are visual and text-only — no sounds, no accounts, no streak guilt. Sessions land in a private local history so consistency is visible without being gamified. The pacer respects reduced-motion settings, and the pattern definitions are one small array your agent can extend in minutes.
- Animated breathing pacer with per-phase countdowns
- Box, 4-7-8, coherent, and long-exhale patterns
- Session lengths from two to ten minutes
- Private session history with minutes and breath counts
- Reduced-motion friendly
breathwork/├── app/the running Next.js app├── agent/START_HERE, PROJECT_MAP, RULES, RECIPES, TESTS, DEPLOY├── CLAUDE.mdread automatically by Claude Code├── AGENTS.mdread automatically by Codex├── .cursor/rules/loaded automatically by Cursor└── README.mdrun it, then make it yours
Inside the app
Customize with AI
Your agent already knows this codebase.
Ships with CLAUDE.md, AGENTS.md, Cursor rules, and a full agent handbook — project map, safety rules, recipes, tests, and deploy notes.
Prompts written against this app
Run it
5 min to your own copy.
- 01Create your editable app copy and unzip it.
- 02Run npm install.
- 03Run npm run dev and open http://localhost:3000.
- 04Read /agent/START_HERE.md before customizing.
- 05Swap the local-first storage boundary for your own backend when ready.
Session history stays in this browser by default.
No account, backend, or cloud sync is included in the current package.
An agent can add optional sync later while keeping offline-friendly local use.
This pilot package is standard-ready for Create My App and AI customization.
A full app-only PWA install route is not enabled yet for this app.
If this isn’t quite right
Take Breathwork and make it yours.
Free, MIT, 5 min to running. The demo above is exactly what lands in your folder.