[AGENTS]

Agents

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.

Agent Protocol / llmstxt.org standard / llms.txt / llms-full.txt

Agent System Prompts & Presets

#

Select your AI assistant to preview and copy the fine-tuned instructions.

/llms.txt ↗
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.

Machine-Readable Endpoints (llmstxt.org)

#

Programmatic feeds optimized for ingestion by autonomous coding tools.

Standard Agent Context

Curated index following the llmstxt.org specification with rules, setup, and component registry.

llms-full.txt Full Reference ↗

Complete LLM Reference

Single-file reference containing every component API, TypeScript prop definition, and TSX snippet.

registry.json shadcn Index ↗

shadcn Registry Manifest

Machine-readable index of all 26 public components, styles, and dependency trees.

Repository Agent Guide

The official agent guide file maintained directly inside the root of the GitHub repository.

Autonomous AI Agent Guidelines

#

Core invariants AI models must follow when generating code with Array UI.

Engineering Rules for AI Assistants

01
Autonomous Workflow: Never pause to ask the user which components to install. Autonomously execute npx shadcn@latest add @aui/<name> -y and proceed immediately.
02
1px Hairline Restraint: Always preserve 1px hairline borders (#dfded9 light, #2c2c38 dark). Avoid rounded bouncy containers or heavy box-shadows.
03
Strict Crimson Discipline: Reserve signature crimson (#e5000f / #ff3344) exclusively for primary action buttons, active navigation indicators, and key focus rings.
04
High Information Density: Design layouts with tight margins, tabular monospace metrics, flat tinted card surfaces (bg-muted/30), and editorial typography.

Complete Registry Component Directory

#

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.