Aura Design System

Rules

Cursor and AI rules for the Aura Design System. Use these in .cursor/rules/ for consistent guidance.

Rules

These rules define foundations and principles for the Aura Design System. You can install them via the registry or copy them into your project's .cursor/rules/ directory.

pnpm dlx shadcn@latest add @aura/rules

Animation guardrails

Compositor-friendly motion, reduced-motion, theme animation tokens. Detail in DESIGN.md.

Aura agent surface

Rules hold guardrails; skills hold execution. DESIGN.md is narrative SoT. Upstream shadcn skill is subordinate to Aura Keep invariants.

Color guardrails

12-step accent/gray scale and APCA contrast roles. Detail in DESIGN.md §2.

DESIGN.md (narrative spec)

Installs the Cursor rule and the project root DESIGN.md (narrative spec). Add with shadcn as @aura/rule-design-md.

Form guardrails

Form system guardrails — useFormDynamic, Form, validateFormData. Procedures in skill aura-forms.

Icon guardrails

Radix icons via className="icon"; no horizontal margins inside gap-owning controls.

Product principles

Non-visual Aura product principles that constrain product and UX choices.

Self-documenting system

Guardrails for the Obsidian Project Brain and Bruno API parity. Write loops live in the update-project-brain skill.

shadcn lint

Aura @shadcn/lint policy (no arbitrary values, no raw colors, no-restyle). Installs Cursor rule + eslint.aura-shadcn.mjs. Add with shadcn as @aura/rule-shadcn-lint or @aura/eslint-shadcn-lint.

Spacing guardrails

Enforce Aura 13px spacing for Tailwind v4

Typography guardrails

Fluid clamp() type scale and 17px floor for editable form controls. Detail in DESIGN.md §3.