Documentation

Durabl is a founding-state React Router application. The copy you receive already contains the stack, the routes, and the decisions. What the application is for is left blank until you write it.

Agent context guide

Before planning or implementing, read AGENTS.md, then ai/core/identity.md, ai/core/guardrails.md, and ai/core/rules.md. Load only the decision, skill, or guide whose trigger matches the task. Prefer the code-standard page for how a change should be written.

If a document conflicts with the code, or with what you asked for, ask before a broad rewrite. Do not read every decision before every change.

Architecture

How the running system behaves. Not where the files sit.

Section	What it covers
Request model	Framework Mode, loaders, actions, Node 24.
Persistence	SQLite, Prisma, and how ids are chosen.
Authentication	Magic links, GitHub, and the session row.
Email	One send function. Resend stays behind it.
Payments	Stripe subscriptions, shipped off.
Deployment	Docker, and the Fly volume.

Codebase

Where a file belongs.

Section	What it covers
Directories	app, ai, prisma, mocks.
Routes	The file tree is the URL tree.
Server modules	The adapters under app/lib.
UI catalog	Atoms, composites, and sections.

Code standard

How new code stays consistent with the copy.

Section	What it covers
TypeScript	tsx for UI, ts for everything else.
Boundaries	Zod parses every value the program did not create.
Format and lint	Oxfmt writes layout. Oxlint checks use.
Tests	Vitest, and the validate script.
Environment	Flags are true or false. A set key is not permission.
Packages	npm, one lockfile.

Decisions

What the product is, and the choices a later session must not undo by accident.

Section	What it covers
What you fill in	The product description starts empty.
How a decision is kept	Edit the file in place. Git is the history.
Decisions in force	The fifteen files under ai/decisions.
Skills	The recipes that ship with the copy.