Skip to main content

Foundation

Why this project exists, what constraints drive decisions, and how features should behave.

Architecture

Framework-agnostic architectural patterns for modern full-stack applications. These principles apply regardless of which framework implements them.

Development Environment

This project runs entirely in a Podman container. The host machine only needs Podman installed - all other tools (Bun, dependencies, build tools) live inside the container.

PRD

Documentation, test-sandbox, and reusable reference in one.

Principles

Decision-making constraints that drive stack choices. Every technology decision should trace back to one or more of these principles.

Progressive Revelation (ProgRev)

> Status: planned. This describes the design philosophy for an intended feature that is not yet built.

Style Randomization

A visual discovery pattern that randomizes decorative styling on each visit, creating memorable first impressions while maintaining usability and accessibility.

User Data Classification

Canonical definitions for user data categories. Other docs reference these terms.

← Back to Docs

Think this pattern could be better? Tell us how.

Leave feedback