Fysk is a next-generation UI component library designed for the modern web. Unlike traditional libraries, Fysk components come with built-in state management - they aren't just static pixels; they manage their own specific local states and interactions out of the box.
Built on top of Radix UI and Tailwind CSS, Fysk prioritizes polished, production-ready aesthetics and developer experience, distributed via a generic "copy-paste" architecture similar to shadcn/ui.
- Built-in State Management: Components handle their own micro-interactions (e.g., a button that has success, loading, and error states and behaves based on state automatically).
- Polished Aesthetics: High-end visual design defaults that look great immediately and are production-ready.
- Copy-Paste Architecture: You own the code. Copy components directly into your project and customize them without fighting a package abstraction.
- Universal Theming: Seamless support for Light/Dark modes, compatible with both Tailwind v3 and v4.
- Stateful Primitives: Focus on functionality with one-prop state handling.
- Framework: Next.js 16 (Turbopack)
- Library: React 19
- Styling: Tailwind CSS
- Primitives: Radix UI
- Package Manager: pnpm
This repository is a Monorepo managed by Turborepo and pnpm.
- Node.js 18+
- pnpm (Required)
- Clone the repository:
git clone https://github.com/ameghcoder/fysk.git
cd fysk- Install dependencies:
pnpm install- Run the development server:
pnpm devThis will start the documentation site at http://localhost:3000.
apps/web: The documentation and examples website (Next.js).fysk: The core component library source.packages/core: Core utilities and scripts.registry: Generated registry files for component distribution.
We welcome contributions! Please ensure you use pnpm for all package management commands to respect the lockfile.
This project is open source and available under the MIT License.