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/mcp package.
• 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.