@ai-created/ui

@ai-created/ui · Open-source design system

Design once. Build without drift.

Designers, engineers, and coding agents build against one versioned interface contract. The same tokens, components, accessibility rules, and page patterns, validated through blocking checks in every consumer.

v1.5.0Stable releaseGitHubReleasesMIT

One system. Three consumers.

Each audience reads a different projection of the same reviewed decisions, never an independent interpretation of them.

System architecture

Each layer has one canonical source. Documentation and machine context are generated from those sources and rejected when they fall out of date.

  1. Semantic tokens

    154 CSS custom properties in styles/tokens.css, mapped into utilities by the shared Tailwind preset.

    styles/tokens.css
  2. Components

    22 documented families exposing 96 verified public exports.

    src/index.ts
  3. Patterns and templates

    7 principal guideline chapters and 6 approved page templates with declared states.

    templates/agent
  4. Documentation and machine context

    This portal, the generated manifest, and the concise and full agent context files.

    design-system.manifest.json
  5. Policy and validation

    6 design-policy rules and 15 blocking validation commands.

    ai-created-ui.config.json
  6. Product consumers

    2 production applications installing immutable release tags.

    consumers.json

Running infrastructure

Every number below is read from a canonical repository source at build time rather than maintained by hand.

Stable release
v1.5.0
Component families
22
Public exports
96
Blocking checks
15

In production

These applications install immutable release tags and run their own compatibility checks before adopting an update. The registry below is the same file the currency tooling reads.

ai-created.com

Compares its installed tag against the latest reviewed GitHub Release and blocks adoption until its own checks pass.

  • npm run policy:check
  • npm run lint
  • npm run typecheck
  • npm run build

Human, Actually

Compares its installed tag against the latest reviewed GitHub Release and blocks adoption until its own checks pass.

  • npm run policy:check
  • npm run typecheck
  • npm run lint
  • npm run test:run
  • npm run build:verify

The quality contract

A change is publishable only when every gate passes. Nothing here is advisory.

Accessibility
Component and axe-based tests plus browser keyboard, focus, and contrast coverage.
Token parity
The generated token artifact and Tailwind preset must match canonical CSS.
Component API parity
Documented props, controls, and geometry must match the public TypeScript.
Design policy
Raw colors, reference tokens, internal imports, and local primitive copies fail the build.
Documentation contract
Public counts, portal routes, and workflow guidance are verified against their sources.
Agent context
The manifest, llms.txt, and llms-full.txt are rejected when stale.
Release and package
The distributable package boundary is verified before a tag is cut.

Read how agent output enters the same system in the agent enforcement chain and how changes are reviewed and released in the governance guideline.

Start where you are

The package is distributed through immutable GitHub tags, not the npm registry. Consumer setup, the install command, and the update lifecycle are documented in the repository README.