Get started
Velora components are source files you own. The shadcn CLI copies them into your project with the keyframes, tokens and dependencies they need — there is no Velora package to install or update.
1. Requirements
React 19, Tailwind CSS v4 and a shadcn/ui project. Starting fresh? Create one with:
pnpm dlx shadcn@latest initVelora doesn't import Radix or Base UI, so it works whichever primitive layer your shadcn project uses. About half the components need motion; the CLI installs it when one does.
2. Add a component
Every component page has its install command. Paste the registry URL:
pnpm dlx shadcn@latest add https://velora.colorlib.com/r/marquee.jsonThat writes components/velora/marquee.tsx and merges any keyframes and brand tokens into your globals.css. Then use it:
import { Marquee } from "@/components/velora/marquee";
export function Logos() {
return (
<Marquee pauseOnHover>
<span>Acme</span>
<span>Northwind</span>
<span>Lumen</span>
</Marquee>
);
}Blocks install the same way and bring every component they use along.
3. Use the @velora namespace (optional)
Register Velora once and install by name instead of URL:
pnpm dlx shadcn@latest registry add @velora=https://velora.colorlib.com/r/{name}.jsonor add it to components.json yourself:
{
"registries": {
"@velora": "https://velora.colorlib.com/r/{name}.json"
}
}Then:
pnpm dlx shadcn@latest add @velora/marquee @velora/hero-globe4. Let your AI agent do it
- shadcn MCP server: run
npx shadcn@latest mcp initand, with the@veloranamespace registered, agents in Cursor, Claude Code or VS Code can search and install Velora components for you. - Copy prompt: every component page has a button that copies the install command, a working example and the props — paste it into any chat.
- llms.txt: /llms.txt indexes everything; /llms-full.txt adds props, accessibility notes and an example for every component.
5. Make it yours
Gradients, beams and glows read four brand variables (--brand, --brand-from, --brand-via, --brand-to) that the CLI adds to your CSS, next to your shadcn tokens. Change them and every component follows — pick a preset on the themes page.
6. Accessibility, built in
Every animated component respects prefers-reduced-motion on its own — so it still does after you install it — and each docs page lists what reduced-motion, keyboard and screen-reader users get. Anything that loops pauses on hover and focus.