Installation
Get KiteUI set up in your Next.js project in minutes.
AI Summary
This guide covers the fastest path to install KiteUI, configure design tokens, and start shipping reusable React + Tailwind UI for SaaS dashboards, portals, and internal tools.
Prerequisites
- Next.js 14+ (App Router recommended)
- Tailwind CSS v4
- shadcn/ui (for base components)
1
Install Dependencies
Install Framer Motion for animations and Lucide for icons:
pnpm add framer-motion lucide-react2
Add Design Tokens
Add the KiteUI color tokens to your globals.css:
@theme inline {
--color-bubble-pink: oklch(0.95 0.03 350);
--color-bubble-sky: oklch(0.95 0.03 220);
--color-bubble-mint: oklch(0.95 0.03 160);
--color-bubble-peach: oklch(0.95 0.03 60);
--color-bubble-lavender: oklch(0.95 0.03 280);
}3
Copy Components
Copy the components from components/profile/ to your project. Each component is self-contained and can be copied individually.
Pro Tip
Start with BubbleCard as it's the foundation for many other components.
4
Import and Use
Import components from the barrel file:
import {
BubbleCard,
ProfileAvatar,
SocialLinkButton,
ThumbnailScroller,
DynamicIsland
} from "@/components/profile"File Structure
components/ ├── profile/ │ ├── index.ts # Barrel exports │ ├── bubble-card.tsx # Base card │ ├── profile-avatar.tsx # Avatar component │ ├── profile-header.tsx # Full header │ ├── social-link-button.tsx │ ├── thumbnail-scroller.tsx │ ├── dynamic-island.tsx │ ├── bubble-slider.tsx │ ├── sports-card.tsx │ ├── store-product-card.tsx │ ├── link-tree.tsx │ ├── stats-widget.tsx │ ├── section-header.tsx │ └── influencer-badge.tsx └── ui/ # shadcn base
AI Editor Rules
The library includes rules files for popular AI-powered editors:
.cursorrules
For Cursor IDE
CLAUDE.md
For Claude Code
.windsurfrules
For Windsurf
copilot-instructions.md
For GitHub Copilot
Related pages
Last updated: 2026-05-14