# ikui

> ikui is a curated collection of reusable React components, blocks, and templates for building captivating landing pages and user-focused marketing materials. Built with React, Tailwind CSS, and Motion, it draws heavy inspiration from shadcn/ui with a magical twist. Components are copy-ready and installable via the shadcn CLI.

Install any component with the shadcn CLI, e.g. `pnpx shadcn@latest add https://ik-ui.pages.dev/r/copy-button.json`. To use the `@ikui` namespace, add `"@ikui": "https://ik-ui.pages.dev/r/{name}.json"` to the `registries` field in your `components.json`.

## Getting Started

- [Introduction](https://ik-ui.pages.dev/docs/introduction.md): Build elegant React interfaces with premium, copy-ready Tailwind CSS components.
- [Components](https://ik-ui.pages.dev/docs/components.md): Browse all available components in ikui.
- [MCP](https://ik-ui.pages.dev/docs/mcp.md): Integrating MCP with ikui lets you control it via AI.

## Components

- [Copy Button](https://ik-ui.pages.dev/docs/copy-button.md): A copy-to-clipboard button with blur transition effect.
- [Audio Waveform](https://ik-ui.pages.dev/docs/audio-waveform.md): A static, width-explicit waveform for timelines. Decodes audio (URL / Blob / AudioBuffer) into normalized peaks — or takes precomputed peaks — and renders mirrored canvas bars at any pixel width, with optional played-progress coloring.
- [Waveform Player](https://ik-ui.pages.dev/docs/waveform-player.md): A compact audio player built on audio-waveform: play/pause, elapsed and total time, played-progress coloring, and click/drag-to-seek on the waveform.
- [Thumbnail Strip](https://ik-ui.pages.dev/docs/thumbnail-strip.md): A viewport-virtualized canvas strip rendering video thumbnails along a horizontal timeline. Pairs with video-thumbnail-cache for the frame decoding.
- [Segmented Timeline Strip](https://ik-ui.pages.dev/docs/segmented-timeline-strip.md): Multi-clip timeline overview built by composing one thumbnail-strip per segment with DOM chrome (active border, dim mask, label, playhead, total duration badge) and click-to-seek.
- [Timeline Ruler](https://ik-ui.pages.dev/docs/timeline-ruler.md): A pure, zoom-aware, horizontally-scrollable time ruler with adaptive tick density, MM:SS / frame labels, and viewport virtualization.
- [Particle Image](https://ik-ui.pages.dev/docs/particle-image.md): Turn any image into an interactive particle field that scatters from the pointer and settles back toward its origin.

## Optional

- [Registry Index](https://ik-ui.pages.dev/r/registry.json): The shadcn registry manifest listing every installable ikui item.
- [GitHub Repository](https://github.com/WuChenDi/ikui): Source code, issues, and contributions.