# BeeUI

> BeeUI is a production-oriented, accessibility-first React Native + Web UI system written in TypeScript, for Expo, bare React Native, and React Native Web. Stable behavior, semantic, and variant APIs do not require callers to know the styling engine (currently Uniwind + Tailwind CSS v4). This file is the AI-agent entry point; the links below resolve to real files in the repository.

STATUS: BeeUI is pre-1.0 and UNPUBLISHED. No `@beemvp/beeui-*` package or CLI is on npm, no `v1.0.0` tag or GitHub Release exists, and the repository is private by owner decision. Package/CLI names and install commands below are release-ready-but-not-published targets, not live registry commands. Do not tell a user to `npm install @beemvp/beeui-ui` or `npx @beemvp/beeui-cli` yet — those resolve to nothing today. The working, in-repo path is the source-ownership CLI (`pnpm beeui -- add <component>`).

BeeUI ships 62 public component modules from `@beemvp/beeui-ui` plus a semantic design-token contract (`@beemvp/beeui-tokens`) and engine-neutral helpers (`@beemvp/beeui-core`). It owns UI only: no router, data-fetching, backend, auth, form-library, or chart framework. Two consumption models coexist — centralized packages and file-level source ownership.

## Packages
- `@beemvp/beeui-core` v20260902.0.0 — Engine-neutral utilities (class-name merging, anchored-overlay geometry) shared by @beemvp/beeui-ui. No React, React Native, or Expo dependency. [unpublished (publishConfig.access=public prepared)] ([packages/core/package.json](packages/core/package.json))
- `@beemvp/beeui-tokens` v20260902.0.0 — BeeUI's design-token system: semantic color/spacing/typography/motion contracts and the canonical Uniwind/Tailwind theme CSS. [unpublished (publishConfig.access=public prepared)] ([packages/tokens/package.json](packages/tokens/package.json))
- `@beemvp/beeui-ui` v20260902.0.0 — Typed React Native + Web components built on @beemvp/beeui-core and @beemvp/beeui-tokens, styled through Uniwind/Tailwind. [unpublished (publishConfig.access=public prepared)] ([packages/ui/package.json](packages/ui/package.json))

## Install (both models, targets are unpublished)
- Centralized (release-ready target, NOT yet on npm): `npm i @beemvp/beeui-ui @beemvp/beeui-core @beemvp/beeui-tokens`, then `import { Button } from '@beemvp/beeui-ui'` and wire the Web theme via `@import '@beemvp/beeui-tokens/theme.css'`. See [docs/decisions/011-distribution-architecture.md](docs/decisions/011-distribution-architecture.md).
- Source ownership (works today, repo-local): `pnpm beeui -- add <component>` copies component source into the consumer and rewrites `@beemvp/beeui-core` imports. The published CLI target is `@beemvp/beeui-cli` (binary `beeui`), invoked `npx @beemvp/beeui-cli add <component>` once released — NOT `npx beeui`. See [docs/registry-cli.md](docs/registry-cli.md) and [docs/distribution-names.md](docs/distribution-names.md).

## Start here
- [README.md](README.md): project overview, quick start, safe-area/overlay/toast foundations.
- [docs/architecture.md](docs/architecture.md): layering, invariants, non-goals, styling-engine boundary.
- [docs/components.md](docs/components.md): canonical per-component contract inventory.
- [docs/roadmap.md](docs/roadmap.md): pre-1.0 plan and hard 1.0 gates.

## Detailed agent surfaces
- [llms-full.txt](llms-full.txt): expanded architecture, setup, compatibility, and contract detail.
- [llms-components.txt](llms-components.txt): the 62 public component modules with exported symbols and source paths.
- [llms-patterns.txt](llms-patterns.txt): production pattern catalog and composition guidance.

## For contributing agents
- [docs/ai-agent-cookbook.md](docs/ai-agent-cookbook.md): AI-agent development contract + task-oriented prompt cookbook (how to consume/build/contribute; unpublished-status rules; ownership boundaries).
- [AGENTS.md](AGENTS.md): code rules (semantic-token-only styling, engine-boundary, accessibility).
- [CONTRIBUTING.md](CONTRIBUTING.md): local setup, required gates, review discipline.
- [docs/agent-execution-contract.md](docs/agent-execution-contract.md): implementation-agent protocol for BeeUI 1.0.

## Optional
- [docs/compatibility-matrix.md](docs/compatibility-matrix.md): pinned/tested React/RN/Expo/tooling versions.
- [docs/theming.md](docs/theming.md): semantic tokens, density, high contrast, branding.
- [docs/anchored-overlays.md](docs/anchored-overlays.md): shared overlay geometry/runtime/portal contract.
- [registry/registry.json](registry/registry.json): machine-readable source-ownership registry.

Generated by scripts/generate-llms-txt.mjs from registry/registry.json, packages/ui/src/index.ts, and packages/*/package.json. Do not edit by hand; run `pnpm llms:generate`.