Installation
Set up BlakeUI Pro in your project.
Requirements
- React 19+
- Tailwind CSS v4
- BlakeUI OSS (
@blakeui/react+@blakeui/styles)
If you haven't set up BlakeUI OSS yet, follow the BlakeUI Quick Start first.
Login
Run the BlakeUI Pro CLI and log in with your GitHub account:
npx blakeui-pro@latest loginA browser tab will open automatically. Sign in with your GitHub account, authorize the application, and wait for the terminal to confirm:
Logged in as @your-usernameInstall
Once logged in, run:
npx blakeui-pro@latest installThe CLI handles everything automatically:
- Adds
@blakeui-pro/reactto your project (if not already present) - Downloads Pro components from the CDN using your license
- Detects missing peer dependencies and installs them with the correct version ranges
- Configures your package manager — for pnpm and bun, offers to allowlist the postinstall script so future installs work seamlessly
You'll see an interactive prompt to confirm which peer dependencies to install. Press Enter to install all of them.
Import Styles
Add BlakeUI Pro styles to your main CSS file (e.g. globals.css):
@import "tailwindcss";
@import "@blakeui/styles";
@import "@blakeui-pro/react/css";Import order matters. Always import tailwindcss first, then @blakeui/styles, then
@blakeui-pro/react/css.
Use a Pro Component
import { OrdersTable } from "@blakeui-pro/react";
function App() {
// Renders a built-in sample dataset out of the box — pass `orders` for your own data.
return <OrdersTable />;
}CLI Reference
| Command | Description |
|---|---|
blakeui-pro login | Log in with GitHub |
blakeui-pro install | Install Pro packages, peer deps, and configure your PM |
blakeui-pro install --yes | Non-interactive install (auto-accept all prompts) |
blakeui-pro install --dry-run | Preview what would be installed without executing |
blakeui-pro status | Show login and installed package info |
blakeui-pro logout | Sign out |
CI/CD
For automated environments (GitHub Actions, Vercel, Netlify, etc.), use a CI/CD token
instead of interactive login. Set the BLAKEUI_AUTH_TOKEN environment variable in your
CI pipeline:
env:
BLAKEUI_AUTH_TOKEN: ${{ secrets.BLAKEUI_AUTH_TOKEN }}When BLAKEUI_AUTH_TOKEN is set, the postinstall script automatically authenticates and
downloads Pro artifacts — no interactive login needed. This works with all package
managers.
Use your CI/CD token for pipelines, not your personal token. CI/CD tokens are scoped to your license and can be rotated independently from the dashboard.
Troubleshooting
Installation fails with permission errors — Try running the CLI with elevated
permissions or check that your package manager has write access to node_modules.
pnpm or bun: postinstall didn't run — The CLI handles this automatically. To
configure manually, add "trustedDependencies" (bun) or "pnpm": { "onlyBuiltDependencies" }
entries for blakeui-pro and @blakeui-pro/react.
Yarn Berry (PnP) not supported — BlakeUI Pro requires node_modules. Add
nodeLinker: node-modules to your .yarnrc.yml.
Authentication expired — Run npx blakeui-pro login to re-authenticate. Sessions are
valid for 180 days.