You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
BoardUI is a React design system for agentic interfaces: the parts an AI product needs and the parts every dashboard needs, in one visual language, as source files in your project. This repository is the whole free tier, and its homepage is a working AI chat on your own model key.
Click the button, paste one API key when Vercel asks for it, and the first deploy already answers.
This repository is generated from BoardUI's source and takes no pull requests. See CONTRIBUTING.md.
Why BoardUI?
Built for agent products. Chat, thinking indicator, agent log, composer and sidebar, next to the tables, cards and forms around them.
Source, not a dependency.npx boardui add copies the files into your project. Change anything.
One visual language. Figma first, 400+ semantic tokens, light and dark from the same classes.
Accessible by default. React Aria Components underneath, Tailwind CSS v4 on top, no runtime CSS.
Agent-native. MCP server, agent skill, AGENTS.md rules and llms.txt, so coding agents build with the system.
What's in this repository
All 62 free items as source: base components, application blocks, tokens and type scale. The catalogue is below.
The app: a chat at /, a dashboard with the two free charts, and sign-in and sign-up screens, all built from the components in this repository. Chat history stays in the visitor's browser. No database.
app/api/chat/route.ts, which reads your key server-side and streams replies. The key never reaches the browser.
Bring your own key
One variable. The provider is read from the key itself:
Key looks like
Provider
Default model
sk-ant-...
Anthropic
claude-haiku-4-5
sk-or-...
OpenRouter
openai/gpt-5-nano
sk-...
OpenAI
gpt-5.4-mini
AIza...
Google Gemini
gemini-2.5-flash
vck_...
Vercel AI Gateway
openai/gpt-5-nano
gsk_...
Groq
llama-3.3-70b-versatile
xai-...
xAI
grok-4-fast-non-reasoning
Create the key with a spending limit where the provider offers one: OpenRouter can cap the credits a key may spend, OpenAI has usage limits per project. The key never reaches the browser, but the chat itself is open to anyone who has your URL, so the cap is what bounds the cost.
Set CHAT_MODEL to use a different model. For Mistral or DeepSeek, whose keys have no recognisable shape, add AI_PROVIDER=mistral or AI_PROVIDER=deepseek. For any OpenAI-compatible server (Ollama, LM Studio, vLLM, LiteLLM, Together) set AI_BASE_URL and CHAT_MODEL. Every provider's usual variable (OPENAI_API_KEY, ANTHROPIC_API_KEY, ...) works too. See .env.example.
Run it locally
npm install
cp .env.example .env.local # then put your key in AI_API_KEY
npm run dev
Install into an existing project
Every component in this repository also installs on its own, as source, into any Next.js project.
With an agent
BoardUI has an MCP server, so Claude Code, Cursor and any MCP client can browse the catalog and install for you. Add it once:
claude mcp add boardui -- npx -y boardui@latest mcp
Cursor and most other clients take the same server in their MCP config:
{
"mcpServers": {
"boardui": { "command": "npx", "args": ["-y", "boardui@latest", "mcp"] }
}
}
Then ask in plain words. "Install every free BoardUI component" installs the whole free catalog in one go. "Add a data table and stat cards to the dashboard" installs just those and wires them in. The rules in AGENTS.md keep whatever it builds on BoardUI's tokens and type scale. Setup for VS Code, Codex and the rest is at boardui.com/mcp.
With the CLI
npx boardui@latest list # every component, one line each
npx boardui@latest add data-table # one component and what it depends on
npx boardui@latest add --all # everything in this repository
Components
Application blocks
Composed screens and panels: sidebars, chat, tables, settings, cards.
A working chat app: app sidebar, streaming replies, thinking indicator, a composer pill with stop control, a chat-history rail with local thread switching, and a setup notice when no provider key is set.
Shared streaming-log machinery: the reveal ticker, the blur-in with its soft clipping edge, and the curved tree guide that draws itself. Behind Task List and Web Search.
Page frame for the chat starter: the sidebar, a phone drawer, and a titled content card, carrying the starter's own navigation so the sidebar only links to pages the app has.
Streaming chat endpoint for agent templates: one AI_API_KEY from OpenAI, Anthropic, Google, OpenRouter, Groq, xAI or Vercel AI Gateway (or any OpenAI-compatible server by URL), a config probe for unconfigured deploys, and the message contract the BoardUI chat UI installs against.
Everything in this repository is free and complete. Pro adds the full-page templates and the richer components, 8 templates and 23 components, installed into the same project as source: npx boardui@latest login <key> once, then add as usual. One-off payment, no subscription. See www.boardui.com/#pricing.
The AI chat composer, whole package: attachment and model menus, voice and send controls, the status bar, and the liquid-glass treatment for its controls.
Streaming research trail: the queries an agent ran and the sources it opened, with real site marks.
Before going public
Requests bill to whoever owns the key, and anyone who has your URL can send them. Three ways to bound that, simplest first: create the key with a spending limit, turn on Vercel's deployment protection for a personal deployment, and put a rate limit in front of /api/chat before pointing the internet at it.
License
MIT. Use it, change it, ship it, share it. BoardUI Pro components and templates are sold separately under the BoardUI License.
About
React design system for agentic interfaces. Every free BoardUI component as source, with a working AI chat app on your own model key as the homepage.