Diego Gonzalez
e1a1196ca9
* refactor(toggles): explicit composition for radio, checkbox & switch Migrate Radio, Checkbox and Switch from child-partitioning to an explicit, React Server Components-safe compound composition. - Add `<X.Button>` (React Aria *Button) as the clickable label wrapping the control + `Label`; remove the child-type inspection that broke under RSC. - Drop `<X.Content>`; `Description`/`FieldError` become siblings of `X.Button` and are exposed via `aria-describedby` for a cleaner accessible name. - Keep a context-based control-only fallback for Checkbox/Switch so label-less usages (e.g. table selection) are unchanged. - Fix Label context bleed inside toggle buttons; retire partition-toggle-field-children. - Update styles, stories, EN/CN demos, component docs and migration guides. BREAKING CHANGE: Radio, Checkbox and Switch no longer expose `*.Content`. Wrap the control and `Label` in `*.Button`, and place `Description`/`FieldError` as siblings of `*.Button`. Control-only checkboxes and switches are unaffected. Co-authored-by: Cursor <cursoragent@cursor.com> * docs(releases): add v3.2.0 release notes Calendar week/day views + multiple selection demos, React Aria 1.18 notes, rolled-in v3.1.1 patch fixes, and the Radio/Checkbox/Switch *.Content -> *.Button breaking-change migration guide (EN + CN). Updates releases index, meta, home release badge, and dictionaries. Co-authored-by: Cursor <cursoragent@cursor.com> * feat(docs): rotating release badges on home hero Replace the single hardcoded release badge with a curated, per-locale releaseBadges list rendered by a Motion-powered carousel: popLayout spring swap, auto-advancing accent progress segments (transform-only scaleX with a soft gradient fade), pause on hover/focus, reduced-motion fallback, and a plain-badge fallback for a single entry. Co-authored-by: Cursor <cursoragent@cursor.com> * docs(releases): point v3.2.0 contributors to PR #6616 Co-authored-by: Cursor <cursoragent@cursor.com> * docs(releases): fix v3.2.0 release PR link to #6616 Co-authored-by: Cursor <cursoragent@cursor.com> * fix(docs): remove release badge progress indicators Drop the carousel segment bars under the home hero release badge. Co-authored-by: Cursor <cursoragent@cursor.com> * docs(releases): add tooltip delay CSS vars to v3.2.0 notes Co-authored-by: Cursor <cursoragent@cursor.com> * refactor(toggles): rename Button to Content and simplify label composition (#6618) Rename Checkbox/Radio/Switch.Button to .Content, remove toggle-specific Label auto-wiring, and update docs, demos, styles, and v3.2.0 release notes. Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: Junior <jrgarciadev@gmail.com>
HeroUI v3 — AI Integration Prompt Packs
System prompts that teach AI code-generation tools to produce correct, idiomatic HeroUI v3 code.
What's in this directory
| File | Purpose |
|---|---|
heroui-system-prompt.md |
Universal prompt — works with any LLM or AI coding tool (Claude, ChatGPT, Cursor, Copilot, etc.) |
v0-heroui.md |
Tailored for v0.dev — emphasizes Next.js App Router, RSC patterns, and Tailwind v4 |
bolt-heroui.md |
Tailored for bolt.new / StackBlitz — includes full Vite setup and runnable single-file examples |
These prompts also work well with Lovable, Replit Agent, Windsurf, and similar AI-powered code generation platforms.
How to use
v0.dev
Paste the contents of v0-heroui.md into v0's system instructions or prepend it to your prompt.
bolt.new / StackBlitz
Paste the contents of bolt-heroui.md at the start of your prompt when creating a new project. It includes the full Vite + Tailwind v4 setup so bolt can scaffold the project correctly.
Cursor / Claude / ChatGPT / Copilot
Use heroui-system-prompt.md as a custom instruction, system prompt, or .cursorrules file. It gives the AI a complete reference of HeroUI v3 components and patterns.
Any other tool
The universal heroui-system-prompt.md works with any tool that accepts system-level instructions.
Richer integrations
For deeper integration beyond system prompts:
- MCP Server — The HeroUI MCP server provides real-time component docs, source code, and theme tokens to AI agents. See the
@heroui/mcppackage. - llms.txt — Full-context documentation following the llms.txt standard, available at heroui.com/llms.txt.
Contributing
When updating these prompts, verify that the component names, APIs, and import patterns match the actual v3 source code in this repo. Run a quick check against the component docs in apps/docs/content/docs/react/components/ to catch any drift.