Flutter
Visor's Flutter component library — a two-layer distribution model using visor_core (pub.dev) for tokens and copy-and-own widgets for components.
Visor ships a first-class Flutter library alongside its React registry. The
same design token system that powers React components is available in Dart via
the visor_core pub.dev package, keeping design consistency across platforms
effortless.
Two-Layer Distribution Model
Visor Flutter uses the same philosophy as the React registry:
-
Tokens →
visor_core(pub.dev). CSS custom properties are mirrored as strongly-typed Dart token classes (VisorColors,VisorTextStyles,VisorSpacing, and more). Addvisor_coreto yourpubspec.yamland runflutter pub get— token updates propagate automatically viapub upgrade. -
Widgets → copy-and-own. Run
visor initandvisor theme apply --target flutterto scaffold apackages/ui/directory in your Flutter project. Each widget file is fully yours to edit — no lock-in, no black-box packages.
Installation
1. Add visor_core
dependencies:
visor_core: ^0.1.0flutter pub get2. Scaffold your UI package
npx visor init
npx visor theme apply --target flutterThis generates a packages/ui/ directory containing:
- Token extension files (
visor_colors.dart,visor_text_styles.dart, etc.) - A
VisorThemewidget that seeds Material 3ThemeDatafrom Visor tokens - Stub widget files for each component you opted into during
visor init
3. Wrap your app
import 'package:ui/ui.dart';
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return VisorTheme(
child: MaterialApp(
home: const HomePage(),
),
);
}
}What's Included
| Layer | Distribution | Updated via |
|---|---|---|
| Design tokens | visor_core on pub.dev | flutter pub upgrade |
| Widget source | Copy-and-own in your project | visor theme apply (re-run) |
| Theme output | Generated packages/ui/ | visor theme apply |
Next Steps
- Getting Started — step-by-step walkthrough
- Theming — customize tokens with
.visor.yaml - Token Reference — all available token classes