Skip to Content

Foundation

Architecture Pillars

01

Shared Packages, Independent Apps

Auth, database, and data models live in workspace packages. Every app gets its own Vercel project with independent deployments, domains, and rollbacks.

02

Schema-Driven Development

LinkML YAML defines the source of truth. TypeScript types and SQL migrations are auto-generated. One change to the schema propagates everywhere.

03

Mantine-First UI

Check @frequencyads/components first, then Mantine primitives. CSS Modules for styling. Never Tailwind, never inline styles. Theme-aware colors only.

04

Security by Classification

Three API tiers with directory-enforced boundaries. PII classification co-located in schemas. Row-Level Security on every table. Quality gates block unsafe code.

05

AI-Assisted Development

Nine specialist agents route your /freq requests to the right expert — from ARCHON for builds to VALIDITUS for security audits. Quality gates run automatically.

Explore the full architecture guide

Reference

Standards & Guides

Everything you need to build on Frequency — from local setup to production deployment.

Architecture

Monorepo structure, shared packages, app patterns, and import boundaries.

Getting Started

Clone the repo, configure your environment, and run your first build.

Tech Stack

Every technology we use, why we chose it, and how the pieces fit together.

UI & Design

Mantine-first components, theming rules, typography, accessibility, and dark mode.

API Standards

Three-tier security model, route patterns, OpenAPI docs, and error handling.

Data & Schemas

LinkML schemas, TypeScript generation, SQL migrations, and Supabase RLS.

Security & Privacy

PII classification, API tiers, middleware security, and quality gates.

AI Development

Agent orchestration, specialist roles, slash commands, and automated reviews.

Deployment

Per-app Vercel projects, custom domains, Route 53 DNS, and PR previews.

Common Workflows

Step-by-step guides: new apps, schema entities, packages, and deployments.

Architecture Decisions

ADRs documenting key technical decisions with context and consequences.

Quick Start

Essential Commands

The commands and paths you'll use every day. Bookmark this section.

terminal

# Start development (all apps)

$ pnpm dev

# Start a specific app

$ pnpm dev --filter=@frequencyads/standards

# Build everything

$ pnpm build

# Type checking

$ pnpm type-check

# Lint & format

$ pnpm lint

# AI-assisted development

$ /freq "implement user auth"

project structure

# Key directories

apps/public/

# No auth

apps/private/

# Auth required

packages/auth/

# Supabase SSR

packages/models/

# LinkML schemas

packages/db/

# Client factory

.ai-drivers/

# 9 agents