A high-performance, copy-paste Flutter UI component library — inspired by shadcn/ui.

JustUI is not a Flutter package you add to pubspec.yaml. Instead, you use the CLI to copy component source code directly into your project. You own the code — no black boxes, no version lock-in, no bloated transitive dependencies.

justui add button

That's it. The component lives in your codebase.

• Zero external dependencies — Built entirely on native Flutter widgets and layout APIs.
• Copy-paste model — Inspired by shadcn/ui. Copy components once, own them forever.
• Aspect-based rebuilds — Uses InheritedModel so only the widgets that depend on a changed theme aspect rebuild. Not the whole tree.
• Dynamic theming — Seed any brand color and get a full accessible light/dark theme automatically, with WCAG AA contrast enforcement baked in.
• Fluid spacing & radii — Scales responsively from mobile (75%) to desktop (100%).
• Ambient tinted shadows — Dual-layer shadow system: crisp key shadow + brand-tinted ambient shadow.
• Rust-powered CLI — Fast, reliable toolchain with interactive prompts, SHA-256 integrity checks, conflict resolution, and dry-run support.

justui/
├── packages/
│   ├── tokens/          # Design system primitives (colors, spacing, typography, shadows)
│   ├── core/            # Theming engine, InheritedModel, seed generator
│   └── cli/             # Rust CLI (justui binary)
├── registry/            # Component source files + index.json
├── apps/
│   ├── docs/            # Next.js + Fumadocs documentation site
│   └── showcase/        # Flutter showcase app
└── docs/                # Phase specs and architecture decisions

Via install script (recommended):

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/infinitedim/justui/main/packages/cli/install/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/infinitedim/justui/main/packages/cli/install/install.ps1 | iex

From source:

git clone https://github.com/infinitedim/justui.git
cd justui/packages/cli
cargo install --path .

From your Flutter project root:

justui init

The wizard will prompt you for:

• Components directory (default: lib/ui)
• Tokens directory (default: lib/tokens)
• Brand color hex (e.g. #3b82f6)
• Theme preset (default or neobrutalism)

This generates justui.config.yaml and bootstraps a theme file at lib/theme/just_theme.dart.

# Add a single component
justui add button

# Add multiple at once
justui add button input card

# Interactive fuzzy multi-select (no args)
justui add

# Preview without writing to disk
justui add button --dry-run

# Show diff before writing
justui add button --diff

The CLI automatically resolves recursive dependencies, verifies SHA-256 checksums, handles conflicts with a three-way prompt, and edits your pubspec.yaml if third-party pub packages are needed.

button · icon-button · input · badge · avatar · checkbox · radio · switch

card · separator · skeleton · scroll-area

tabs · breadcrumb · sidebar · bottom-nav

Always use aspect-specific extensions in build() to avoid unnecessary rebuilds:

@override
Widget build(BuildContext context) {
  final colors  = context.justColors;   // rebuilds only when colors change
  final spacing = context.justSpacing;  // rebuilds only when spacing changes
  final typo    = context.justTypo;     // rebuilds only when typography changes

  return Container(
    padding: .symmetric(horizontal: spacing.md),
    color: colors.background,
    child: Text('Hello', style: typo.bodyMd),
  );
}

In event callbacks, use the non-registering read API:

onPressed: () {
  final colors = context.readTheme().colors;
}

MaterialApp(
  theme: JustThemeData.light.toThemeData(),
  darkTheme: JustThemeData.dark.toThemeData(),
  home: const MyHomeScreen(),
)

For CupertinoApp or WidgetsApp, wrap manually with a Theme widget:

CupertinoApp(
  builder: (context, child) => Theme(
    data: JustThemeData.light.toThemeData(),
    child: child!,
  ),
  home: const MyHomeScreen(),
)

Full documentation at docs.justui.dev — installation, theming, all component APIs, and guides.

See CONTRIBUTING.md for setup instructions, coding rules, and how to add components to the registry.

MIT