Architecture

Project Structure

src/
├── components/        # Reusable UI components
│   ├── admin/         # Admin components
│   ├── forms/         # Form-related components
│   └── ui/            # General UI components
├── config/            # Application configuration
├── email-templates/   # Email templates
├── layouts/           # Page layouts
├── lib/               # Shared utilities and helpers
├── middleware/        # Request middleware
├── pages/             # Application routes & templates
├── styles/            # Tailwind integration, base component styles

Core Concepts

Middleware

Request processing and authentication handling.

App Config

Centralized application configuration in src/config/.

Schema & Migrations

Database schema definitions and Kysely migrations.

Auth + RBAC

Better-Auth integration with role-based access control.

CRUD Helper

Abstraction layer for common database operations.

Design Philosophy

Modular, interconnected full-stack components built on a reasonable spec. Architectural decisions that minimize technical debt.