# RicoUI Blocks

> React + Tailwind CSS 4 components with expressive interactions. Copy source or install with shadcn Registry URLs.

Website: https://blocks.ricoui.com
Repository: https://github.com/ricocc/ricoui-blocks

## Usage

Requires React and Tailwind CSS 4. Components are independent of TanStack Start and do not require shadcn/ui at runtime. Respect reduced-motion preferences. Component code is in registry/; preview controls are website-only. RicoUI’s own code is licensed under MIT: https://github.com/ricocc/ricoui-blocks/blob/main/LICENSE. Preserve the copyright and license notice. Third-party code, fonts, and other assets retain their own licenses; consult their notices and each template repository.

## Documentation

- [Getting started](https://blocks.ricoui.com/docs)
- [Browse components](https://blocks.ricoui.com/browse)
- [Component catalog](https://blocks.ricoui.com/components)
- [Privacy](https://blocks.ricoui.com/privacy)
- [Complete source and API documentation](https://blocks.ricoui.com/llms-full.txt)

## Components

- [GitHub Repo](https://blocks.ricoui.com/components/github-repo): A tactile repository card with a blue clasp, vector Octocat badge, warm halftone star button, and layered contact shadows.

- [Bell Button](https://blocks.ricoui.com/components/bell-button): A notification button with a bell, optional count badge, and the beveled light and dark finishes of RicoUI Button.

- [Button](https://blocks.ricoui.com/components/button): A native button in the RicoUI palette, with light and dark themes, six variants, and built-in loading and disabled states.

- [Dither Progress](https://blocks.ricoui.com/components/dither-progress): A horizontal Dither Pop progress bar with a blue capsule, lightning badge and warm halftone fill that grows denser as progress advances.

- [Flip Switch](https://blocks.ricoui.com/components/flip-switch): A horizontal Dither Pop rocker switch with a blue housing, warm two-tone paddle and fine halftone details.

- [Magnifier](https://blocks.ricoui.com/components/magnifier): A precision optical magnifier with a projected metal housing, inertial drag and a curved magnifying lens.

- [File Organizer](https://blocks.ricoui.com/components/file-organizer): A colorful desktop file box with layered folders, crisp halftone surfaces and a staggered opening sequence.

- [Contribution Graph](https://blocks.ricoui.com/components/contribution-graph): A five-level blue contribution heatmap with ASCII details and an interactive canvas companion.

- [Empty States](https://blocks.ricoui.com/components/empty-states): Twelve precision-crafted empty states with porcelain surfaces, recessed panels, chamfered frames and engraved details. Original SVG scenes with layered mechanical animation.

- [Kubai Empty States](https://blocks.ricoui.com/components/kubai-empty-states): Twelve miniature product interfaces for empty, unavailable, and failed states. Self-contained SVG with light, dark, and system themes.

- [Popin Preloader](https://blocks.ricoui.com/components/popin-preloader): A pale blue-gray loading screen with a brand-blue sweep, elastic Ready letters, and an upward curtain exit.

- [Clip Image Preloader](https://blocks.ricoui.com/components/clip-image-preloader): A logo and counter lead into seven clipped photographs, arranged as a responsive montage, then darkened and lifted away.

- [Step Overlap Preloader](https://blocks.ricoui.com/components/step-overlap-preloader): A softly blurred letter entrance and corner counter, followed by white, pale blue, and brand-blue curtains that lift in sequence.

- [Social Card](https://blocks.ricoui.com/components/social-card): A stack of social links with luminous gradients, blurred color, and fine grain. Hover or focus to spread the centered cards in both directions; touch devices show an open grid. Includes a standalone HTML version.

- [ASCII Background](https://blocks.ricoui.com/components/ascii-background): Blue ASCII currents drift across light and dark canvases, with ripples that follow your pointer. Available as a React component or a standalone HTML file.