Beyond Material & Cupertino

Flawless is a headless styling engine for Flutter. You compose UI from stable contracts and design tokens, while swapping concrete implementations (Material 3, Glass, etc.) without rewriting your app.

Why "Headless" for Flutter?

• Design-system first: tokens + component properties are decoupled from widgets.
• Portable decisions: re-skin or A/B test themes without refactoring screens.
• CLI Orchestration: managing 8+ packages and design systems at scale becomes a one-command task.

---

The Flawless Suite

Flawless is composed of 8 modular packages to give you total control over your styling stack:

Package	Purpose
flawless_cli	The brain of the operation. Orchestrates onboarding and suite syncing.
flawless_core	Foundational contracts and headless styling primitives.
flawless_ui	Facade widgets that dispatch to the active theme implementation.
flawless_theme	The bridge for standard Flutter theme integration and subtree overrides.
flawless_glass_theme	Tokens and logic for sophisticated glassmorphism.
flawless_glass_components	Glass-styled UI built on Flawless contracts.
flawless_material3_theme	Adaptive bridge for Material 3 design systems.
flawless_material3_components	Material 3 components powered by Flawless logic.

---

Project Structure Evolution

Flawless has been reorganized to separate core logic from community-driven innovation.

flawless/
├── packages/           # 📦 Core Suite (160/160 Quality Score)
│   ├── flawless_core   # Headless contracts & primitives
│   ├── flawless_cli    # Orchestration tool
│   └── ...             # Theme & Component implementations
├── community/          # 🤝 Community Lab
│   ├── proposals/      # RFCs & Markdown specs for new components
│   └── experimental/   # Unfinished/Voted community builds
└── examples/           # 🚀 Showroom
    └── showcase_apps/  # Full-scale sample apps (e.g., Liquid Fintech)

Quick Start

1) Install the CLI

dart pub global activate flawless_cli

2) Initialize

From the root of your Flutter project:

flawless_cli init --with-sample --wire-main

3) Switch Themes (Example)

flawless_cli add theme glass

---

Development & Quality

This workspace is managed with Melos.

dart run melos bootstrap
dart run melos run analyze
dart run melos run test

Contributing

Thank you for considering contributing to the Flawless suite! But make sure to check the CONTRIBUTING.md file first.

Code of Conduct

In order to ensure that the Flawless community is welcoming to all, please review and abide by the Code of Conduct. Any violations of the code of conduct may be reported to Flawless Team (flawless@codelabmw.dev):

• Participants will be tolerant of opposing views.
• Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
• When interpreting the words and actions of others, participants should always assume good intentions.
• Behavior that can be reasonably considered harassment will not be tolerated.

Security Vulnerabilities

If you discover a security vulnerability within Flawless, please send an e-mail to Flawless Team via flawless@codelabmw.dev. All security vulnerabilities will be promptly addressed.

License

Open-sourced software licensed under the MIT license.