Build Standards

Naming, structure, and HTML semantics rules that keep every Brik page and component consistent.

Rules for building pages and components that stay coherent as the system grows. Every standard here is load-bearing — it resolves a word, a slot, an element, or a layout decision before you write code.

Naming Principles

Intent over shape. The closed allowlist that governs every slot name.

Slot Vocabulary

Full reference for title, subtitle, description, label family, actions, value, Tag, and Badge.

Composition Layers

Five layers — Section, Layout, Container, Block, Component — and the decision rules.

HTML Semantics

Which HTML element each role renders as, heading hierarchy, stable IDs, and no-unclassed-wrappers.

Prop Axes

Shared prop names — size, status, variant, appearance — and the component coverage matrix.

Page Structure

The HTML skeleton and BEM section pattern for Astro and Next.js sites.

Token Anatomy — How token names are structured (primitive, intent, scoped intent).
Theming — Blueprints — Blueprint families and how they implement the Section layer.
Components — Every component implements the prop axes and slot vocabulary defined here.