Aolda

Aolda's component library for building modern web applications.

Aolda provides accessible, design-system-compliant UI components built on Base UI. It handles keyboard navigation, focus management, and ARIA attributes so you can build accessible applications without thinking through every detail.

Note

Aolda Design System is based on the structure of Cloudflare Kumo and is maintained independently for Aolda's component library, design tokens, and documentation.

Installation

pnpm add @aolda/ui

Peer Dependencies

pnpm add react react-dom @phosphor-icons/react

Usage

import { Button, Input, Dialog } from "@aolda/ui";
import "@aolda/ui/styles";

Granular Imports (Tree-Shaking)

import { Button } from "@aolda/ui/components/button";

Base UI Primitives

Aolda re-exports all Base UI primitives for advanced use cases:

import { Popover } from "@aolda/ui/primitives/popover";

Component Registry

Aolda generates machine-readable component metadata for docs and tooling:

jq '.components.Button.props' packages/ui/registry/component-registry.json

Development

See AGENTS.md for comprehensive development documentation including:

• Component patterns and styling system
• Semantic color tokens
• Development workflows
• CI/CD pipeline

Quick Start

pnpm install
pnpm dev                    # Start docs site at localhost:4321
pnpm --filter @aolda/ui test

Creating Components

pnpm --filter @aolda/ui new:component

Documentation

• Live Docs: ui.aoldacloud.com
• AI/Agent Guide: AGENTS.md

License

MIT