Developer Reference

Reference material for working on the BSN codebase — architecture, local setup, and conventions. This section is auto-listed in the sidebar from everything in this folder; this page is just an index.

Start here

Document	Purpose
Local Supabase Setup	Getting a local backend running for development
Supabase Architecture	How the database, auth, and RLS are structured
Feature Flags	The flag system and what each flag controls
Design System	Tokens, components, and theming conventions
Infrastructure	AWS, Cloudflare, and the Terraform/Terragrunt setup
Testing Strategy	Testing approach across the test suite

Testing commands

make test-watch        # Unit tests, watch mode — start here for day-to-day dev
make test               # Full unit test run
make test-e2e            # Playwright E2E suite
make lint                # Code style
make type-check          # TypeScript validation
make qa                  # All of the above

See make help for the complete command list.

A note on this section

A few documents previously linked from here (a dedicated TESTING.md, ci-cd-pipeline.md, and several E2E/CI sub-guides) don’t exist in this folder — this page used to link to them anyway. Removed those links rather than leave them dangling; if that material still exists somewhere else in the repo, it’s worth moving it here properly rather than re-adding the links.