# Kivi UI

> Kivi UI is a free, modern React and Tailwind CSS component library designed for high-performance web applications with production-ready micro-interactions, canvas/WebGL shaders, and accessible building blocks.

## Core Resources

- [Home](https://kiviui.dev/): Explore Kivi UI, features, component highlights, and quick installation.
- [Components Index](https://kiviui.dev/components): Complete catalog of animated React and Tailwind CSS UI components.
- [Building Blocks](https://kiviui.dev/blocks): Full-page section blocks including FAQ, Testimonials, and Authentication.
- [WebGL Shaders](https://kiviui.dev/shaders): GPU-accelerated GLSL WebGL background shaders and visual canvas components.
- [Backgrounds & Patterns](https://kiviui.dev/backgrounds): Modern CSS gradients, radial patterns, and grid overlays.
- [Shadow Maker Tool](https://kiviui.dev/shadow-maker): Interactive generator for layered CSS and Tailwind box shadows.

## Documentation & Setup Guides

- [Introduction](https://kiviui.dev/docs/introduction): Overview, philosophy, and architecture of Kivi UI.
- [Project Setup](https://kiviui.dev/docs/project-setup): Step-by-step setup instructions for Next.js and React + Vite projects.
- [CLI Setup & Usage](https://kiviui.dev/docs/cli): Official guide for installing components via the Kivi UI CLI and shadcn CLI.
- [MCP Server Integration](https://kiviui.dev/docs/mcp): Model Context Protocol server configuration for AI coding assistants.
- [Code Structure](https://kiviui.dev/docs/code-structure): Architectural conventions, flat component hierarchy, and design standards.

## Popular Components

- [Keyboard](https://kiviui.dev/components/keyboard): Fully functional virtual keyboard UI component with mechanical audio feedback and dark mode.
- [Animated Button](https://kiviui.dev/components/animated-button): Interactive button with smooth hover physics and micro-animations.
- [Shiny Button](https://kiviui.dev/components/shiny-button): Modern button with metallic shimmer border animations.
- [Spotlight Card](https://kiviui.dev/components/spotlight-card): Cursor-following radial glow card for featured content.
- [Bento Grid](https://kiviui.dev/components/bento-grid): Responsive bento-box grid layouts with staggered reveals.
- [Globe 3D](https://kiviui.dev/components/globe-3d): Interactive Three.js/WebGL rotating globe with custom markers and arcs.
- [Particle Image](https://kiviui.dev/components/particle-image): Interactive particle dispersion and canvas hover effect.
- [Smoke Shader](https://kiviui.dev/shaders/smoke-shader): Smooth GLSL smoke shader for dark-mode hero sections.
- [Koi Pond Shader](https://kiviui.dev/shaders/koi-pond): GPU-rendered ripple physics and swimming koi canvas background.

## Component Categories

- [Button Components](https://kiviui.dev/categories/button): Interactive buttons, magnetic actions, and CTA states.
- [Text & Typography](https://kiviui.dev/categories/text): Word swap text, typewriter effects, and letter reveal transitions.
- [Cards & Bento](https://kiviui.dev/categories/card): Spotlight cards, expandable card stacks, and bento grids.
- [3D & WebGL Canvas](https://kiviui.dev/categories/3d): Interactive 3D globes, particle canvases, and GLSL shaders.
- [Interactive Showcase](https://kiviui.dev/showcase): Live websites and client projects crafted with Kivi UI.

## Optional

- [About Kivi UI](https://kiviui.dev/about): Creator notes, mission, and technology stack.
- [Feedback & Requests](https://kiviui.dev/feedback): Submit bug reports and feature requests.
- [Full LLM Context (llms-full.txt)](https://kiviui.dev/llms-full.txt): Complete uncompressed API and component documentation for LLM ingestion.
- [OpenAPI Specification](https://kiviui.dev/openapi.json): Structured JSON specification of available components and registry endpoints.
- [XML Sitemap](https://kiviui.dev/sitemap.xml): Comprehensive URL directory for web and agent crawlers.