Introduction

Welcome to Flux UI

Merchant-grade primitives you install and own — same stack we ship in the dashboard.

The package is published as @flux/ui so you can reuse the same tokens, spacing, and components in your own product.

Philosophy

This is not a black-box component library. You install dependencies, copy or import source-style primitives, and keep full control. That means you can theme, fork, and extend without waiting on a vendor release cycle.

Open code

  • Composition — small pieces (Field, Input, Dialog) that combine into flows you define.
  • Distribution — npm package with TypeScript source exports; optional path aliases in a monorepo.
  • Beautiful defaults — Flux blue, neutral surfaces, and chart tokens out of the box.
  • Accessible — Radix primitives where it matters; visible focus and keyboard support.

Stack

React 18+, Tailwind CSS v4 with @source over the package, CSS variables for theming, and optional Recharts for the chart layer. See Installation for the fastest path to a working app. Use the sidebar for Foundations (Motion, Typography, Spacing), Patterns (dashboard shell, forms), and the full component catalog.

License

@flux/ui is released under the MIT License.