AI-native design system that remembers why.

Explore real nanaOS components and patterns below. Open any card to configure its rendered Viewport, Prompt for AI, and React code using the same public contract a product installs.

Adopt nanaOSOpen agent interface
One authored source generates a catalog for people, contracts for agents, and runtime packages for products.Authored truthtokens + SCSSrecipe.tscanonCatalogfor peopleContractsfor agents</>CSS + Web Componentsworks anywhereReacttyped props

Playground

Chip
Combobox
Drawer
Hover Card
Sidebar
Table of Contents
Tabs
Textarea
Toast
Tooltip
Search Dialog
01 · Philosophy

Single source of truth for humans and agents.

Authored truth5 principles

Design system principles

  1. Consistency
  2. Scalable
  3. Maintainable
  4. DRY (Don't Repeat Yourself)
  5. Agent-friendly
  1. Catalogfor people
  2. Contractsfor agents
  3. CSS + Web Componentsworks anywhere
  4. Reacttyped props
  5. Agent gatewaymachine-readable
Five design system principlesOne authored language for humans and agents.
01

Consistency

One intent keeps one semantic name across themes, design, components, and product UI.

02

Scalable

Measured primitives and stable semantic aliases grow without re-ranking the system.

03

Maintainable

Every decision has one owned source, with generated surfaces derived from it.

04

DRY

Tokens, recipes, contracts, previews, and adapters are reused or generated instead of copied.

05

Agent-friendly

Public contracts and semantic APIs make intent legible to people and agents without reverse-engineering pixels.

02 · Adoption

Start clean or migrate with evidence.

The package now carries the runtime, full prop contracts, framework adapters, migration report, and strict consumer audit needed to keep unsupported UI out of a product.

01

Install one package

Runtime CSS, adapters, contracts, patterns, fonts, icons, and the CLI share one version.

npm install @nanacodesign/nanaos-design-system
02

Choose one runtime

React apps use generated client adapters. Other stacks register the same n-* Web Components.

import { Button } from "@nanacodesign/nanaos-design-system/react";
03

Theme through semantics

Product identity enters through the nanaos.product layer without forking component CSS.

npx nanaos init theme
04

Gate every migration

Strict audits turn unsupported UI into file-and-line remediation instead of visual guesswork.

npx nanaos migrate adopt . && npx nanaos audit --strict
One system · two fluent readers

Beautiful enough to explore. Explicit enough to migrate.

nanaOS turns design intent into an installable, testable operating system for product UI.

Return to PlaygroundView source
On this pageTable of Contents
Table of ContentsPlaygroundPhilosophyAdoption