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-react
2

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