Array UI is architected for autonomous AI coding assistants (Cursor, Claude Code, Windsurf, Codex, Antigravity) who need machine-readable specifications, copy-paste prompts, and instant component installations.
Select your AI assistant to preview and copy the fine-tuned instructions.
You are an expert engineer building UI with Array UI (array-ui), an editorial engineering design system inspired by arpitbhayani.me.
# Documentation & Registry
- Official Site & Catalog: https://ui.arpitbhayani.me
- LLM Context: https://ui.arpitbhayani.me/llms.txt
- Comprehensive Reference: https://ui.arpitbhayani.me/llms-full.txt
- shadcn Registry: https://ui.arpitbhayani.me/r/{name}.json
- Registry Index: https://ui.arpitbhayani.me/r/registry.json
- GitHub Repo: https://github.com/arpitbbhayani/aui
- Package (npm): array-ui
# Installation Modes
1. If project uses shadcn/ui:
- Add "@aui": "https://ui.arpitbhayani.me/r/{name}.json" under "registries" in components.json.
- Run: npx shadcn@latest add @aui/aui -y (base theme tokens)
- Run: npx shadcn@latest add @aui/<component> -y (e.g. button, badge, card, terminal, ping-status)
- Import from "@/components/ui/<component>".
2. If project uses direct package (Next.js, Astro):
- Run: npm install array-ui (or pnpm add array-ui / bun add array-ui)
- Add import "array-ui/styles.css"; to root layout.
- Import from "array-ui/nextjs" (Next.js) or "array-ui/astro/[Component].astro" (Astro).
# Autonomous Workflow (IMPORTANT):
- When given a task or UI requirement, autonomously select all needed @aui components.
- DO NOT pause or ask the user which components to install.
- Automatically execute the installation command (e.g. `npx shadcn@latest add @aui/<component> -y`) and immediately proceed to building the requested interface.
- Strictly Maintain 0% Custom CSS: Never write page-level `<style>` blocks or ad-hoc `.css` files. All layout, spacing, and styling MUST be driven exclusively by Array UI components and foundational utility classes.
# Aesthetic Rules:
- Palette: Paper canvas in light mode (#f9f8f5), obsidian carbon in dark mode (#121215).
- Hairline borders: Single 1px borders everywhere (#dfded9 in light, #27272c in dark).
- Accents:
- Signature Crimson (#e5000f in light, #ff3344 in dark) ONLY for primary action buttons, active tabs, and focus rings.
- Amber (#cc9900) exclusively for engineering maxim quotes and warnings.
- Emerald (#10b981) for operational status & diff additions; Rose (#f43f5e) for outages & diff deletions.
- Typography: Assistant bold headings and body (15px base), Lora italic serif quotes, IBM Plex Mono code.
- Always use cn() from @/lib/utils for custom classes.
Programmatic feeds optimized for ingestion by autonomous coding tools.
llms.txt
Standard Context ↗
Curated index following the llmstxt.org specification with rules, setup, and component registry.
llms-full.txt
Full Reference ↗
Single-file reference containing every component API, TypeScript prop definition, and TSX snippet.
registry.json
shadcn Index ↗
Machine-readable index of all 26 public components, styles, and dependency trees.
AGENTS.md
Repository Guide ↗
The official agent guide file maintained directly inside the root of the GitHub repository.
Core invariants AI models must follow when generating code with Array UI.
npx shadcn@latest add @aui/<name> -y and proceed immediately.
#dfded9 light, #2c2c38 dark). Avoid rounded bouncy containers or heavy box-shadows.
#e5000f / #ff3344) exclusively for primary action buttons, active navigation indicators, and key focus rings.
bg-muted/30), and editorial typography.
All 26 components available via the shadcn CLI registry with copyable commands.
| Component | Registry Target | Description | CLI Install Command |
|---|---|---|---|
| Button |
@aui/button
|
Tactile action buttons with signature crimson primary, secondary, outline, ghost, and danger variants. | |
| Badge |
@aui/badge
|
Status pills and tag badges (crimson, emerald green, amber, rose red, sky blue, outline). | |
| Card |
@aui/card
|
Flat card surface with 1px hairline border, header, title, description, content, and footer. | |
| Input |
@aui/input
|
Machined text input with subtle focus ring and optional keyboard shortcut badge. | |
| Kbd |
@aui/kbd
|
Monospace keyboard shortcut keycap badge. | |
| Tooltip |
@aui/tooltip
|
Accessible tooltip hint on hover and focus. | |
| Alert |
@aui/alert
|
Status-tinted inline alert callout (info, success, warning, destructive). | |
| Tabs |
@aui/tabs
|
Underline tab navigation with keyboard accessibility. | |
| Accordion |
@aui/accordion
|
Collapsible hairline accordion sections for FAQs and structured content. | |
| Dropdown |
@aui/dropdown
|
Minimal click-trigger dropdown menu with click outside dismissal and actions. | |
| Terminal |
@aui/terminal
|
Machined telemetry terminal with bash command dots and styled outputs. | |
| DiffBlock |
@aui/diff-block
|
Git patch viewer with line gutters, additions, and deletions. | |
| PingStatus |
@aui/ping-status
|
Live telemetry pulsing dot indicator with status and latency. | |
| PropertyGrid |
@aui/property-grid
|
Key-value metadata inspector with one-click copy functionality. | |
| PackageManager |
@aui/package-manager
|
pnpm/npm/bun/yarn command switcher with copy button. | |
| FileTree |
@aui/file-tree
|
Directory explorer tree with collapsible folders and item selection. | |
| Maxim |
@aui/maxim
|
Editorial quote callout with amber left rail and citation. | |
| TakeawaysBox |
@aui/takeaways-box
|
Key takeaways container with bulleted highlights. | |
| Hero |
@aui/hero
|
Editorial profile hero section with avatar, heading, and bio. | |
| SocialPill |
@aui/social-pill
|
Clean pill button with platform icon, handle, and follower count. | |
| CourseCard |
@aui/course-card
|
Editorial course and project card with badges, tags, and CTA. | |
| StatCard |
@aui/stat-card
|
Large key metric display card with optional trend indicator. | |
| EmptyState |
@aui/empty-state
|
Dashed container for empty content and call-to-actions. | |
| Footer |
@aui/footer
|
Editorial 4-column directory footer with category hints and disclaimer. | |
| Modal |
@aui/modal
|
Accessible dialog modal with backdrop blur and escape key dismissal. | |
| VideoEmbed |
@aui/video-embed
|
Responsive 16:9 aspect ratio video embed wrapper with border hairline styling. | |
| Gutter |
@aui/gutter
|
Whitespace blank spacing primitive between UI elements with named presets (2xs to 4xl) and horizontal/vertical axes. |