ADR Library
Curated packs of architecture decisions, ready to add to your repo.
v0.1.0
Accessibility requirements for web components — alt text, accessible names, tab order.
curatedconcern:accessibilitylanguage:typescriptlanguage:javascriptframework:react
3 ADRs
v0.1.0
Keep Markdown prose and code comments free of the tells catalogued in Wikipedia's "Signs of AI writing" — leftover model artifacts, machine-shaped document structure, and AI-register wording.
curatedconcern:documentationconcern:ai-governancelanguage:markdown
3 ADRs
v0.1.0
Bun as the unified package manager and TypeScript runtime — replaces npm/yarn/pnpm and ts-node/nodemon.
curatedruntime:bunlanguage:typescriptconcern:toolchain
1 ADRs
v0.1.0
Complete SQLite data layer with Drizzle ORM — schema, migrations, UUID v7 keys, audit fields, naming conventions, environment separation.
curateddatabase:sqliteorm:drizzlelanguage:typescript
7 ADRs
v0.1.0
Backend for Frontend with Hono — BFF pattern, type-safe API with Zod OpenAPI, and standardized folder structure.
curatedframework:honolanguage:typescriptstack:backend
3 ADRs
v0.1.0
End-to-end type safety between Hono backend and React frontend — types flow from Drizzle to Zod to Hono RPC to the UI.
curatedframework:honoframework:reactlanguage:typescriptconcern:type-safety
1 ADRs
v0.1.0
Internationalization with i18next and react-i18next — type-safe translations with bundled JSON files.
curatedframework:reactlibrary:i18nextlanguage:typescript
1 ADRs
v0.1.0
Jotai for client-side global state — atomic state management for React applications.
curatedframework:reactlibrary:jotailanguage:typescript
1 ADRs
v0.1.0
Monorepo management with Moonrepo — task orchestration, caching, and standardized folder structure.
curatedtool:moonrepoconcern:monorepolanguage:typescript
3 ADRs
v0.1.0
MUI (Material UI) as the React component library — theming, layout primitives, and accessible components.
curatedframework:reactlibrary:muilanguage:typescript
1 ADRs
v0.1.0
Next.js App Router conventions — server-first components, data fetching boundaries, route handler exports.
curatedframework:nextjslanguage:typescriptruntime:node
3 ADRs
v0.1.0
REST API conventions for Node.js backends — consistent errors, route colocation, request validation.
curateddomain:rest-apiruntime:nodelanguage:typescript
3 ADRs
v0.1.0
Observability conventions — structured logging, request ID propagation, error tracking.
curatedconcern:observabilitylanguage:typescriptlanguage:javascript
3 ADRs
v0.1.0
Code formatting with Prettier and linting with Oxlint for TypeScript and JavaScript projects.
curatedtool:prettiertool:oxlintlanguage:typescriptlanguage:javascriptconcern:quality
2 ADRs
v0.1.0
Toolchain version management with Proto — pin and synchronize tool versions from a single file.
curatedtool:protoconcern:toolchain
1 ADRs
v0.1.0
Python data pipeline toolchain — UV package management, ty type checking, and sidecar data import jobs.
curatedlanguage:pythontool:uvtool:tyconcern:data
4 ADRs
v0.1.0
Core React SPA architecture — TypeScript, Vite, component patterns, folder structure, no barrel files, no path aliases.
curatedframework:reactlanguage:typescriptbuild:vitestack:frontend
7 ADRs
v0.1.0
Security baseline — no secrets in code, no eval, dependency review.
curatedconcern:securitylanguage:typescriptlanguage:javascript
3 ADRs
v0.1.0
Storybook for isolated React component development — stories, interaction tests, and visual regression.
curatedframework:reacttool:storybookconcern:testinglanguage:typescript
1 ADRs
v0.1.0
Form management with TanStack Form — type-safe forms with Zod validation and controlled state.
curatedframework:reactlibrary:tanstack-formlanguage:typescript
1 ADRs
v0.1.0
Server state management with TanStack Query — caching, background refetching, and optimistic updates.
curatedframework:reactlibrary:tanstack-querylanguage:typescript
1 ADRs
v0.1.0
File-based routing with TanStack Router — type-safe routes, params, search params, and loaders.
curatedframework:reactlibrary:tanstack-routerlanguage:typescript
1 ADRs
v0.1.0
Full-stack architecture for data-driven desktop apps — Tauri v2, Hono BFF, SQLite + Drizzle, React 19 + MUI + TanStack, Bun, Moonrepo.
curatedstack:desktopframework:tauriframework:reactframework:honoruntime:bunlanguage:typescriptlanguage:pythondatabase:sqliteorm:drizzlebuild:moonrepo
38 ADRs
v0.1.0
Testing conventions — colocated tests, no .only/.skip committed, descriptive names.
curatedconcern:testinglanguage:typescriptlanguage:javascript
3 ADRs
v0.1.0
Strict TypeScript baseline — no any, explicit return types, strict tsconfig, no non-null assertions.
curatedlanguage:typescriptruntime:noderuntime:bunruntime:deno
4 ADRs