Studyflash

Engineering handbook lives in internal/docs/ and is autodiscovered from docs/**/*.md. Run pnpm dev inside internal/docs/ and browse /repo.

Where to look

• Engineering principles — three rules, apply everywhere
• Monorepo structure — apps, packages, infra, internal
• Coding conventions — backend + frontend
• Development process — idea → ship
• Working with AI — pair vs peer programming, the slop rule
• Operations — bugs + support
• Postmortems — template + past incidents

Quick start

Prerequisites: Node.js, pnpm v10, Deno, Python 3, Docker, Infisical CLI.

If you use Homebrew (macOS or Linuxbrew), brew bundle from the repo root installs everything via the checked-in Brewfile.

pnpm install        # install dependencies
pnpm dev            # interactive dev launcher
pnpm dev:local      # full local dev stack
pnpm build          # build all apps
pnpm test           # run tests
pnpm lint           # lint all packages