Flocks

A Flutter design system built on widgets.dart — no Material, no Cupertino.

Six of the seven packages are published on pub.dev under the jotapeconsultoria.com.br verified publisher. The seventh is the demo, which is a showcase and not a library.

Package	What it is
`flocks` · pub.dev	The design system: tokens, theme, white-label brand, and the components.
`flocks_phosphor` · pub.dev	Phosphor Icons as an `AppIconProvider` — six weights, shipped as fonts so the tree-shaker can prune them.
`flocks_material` · pub.dev	Material Design icons as an `AppIconProvider`. The reference implementation of the axis.
`flocks_cupertino` · pub.dev	The `cupertino_icons` glyphs as an `AppIconProvider` — the iOS visual vocabulary, under MIT. Not Apple's SF Symbols.
`flocks_lucide` · pub.dev	Lucide as an `AppIconProvider` — one stroke weight, shipped as a font so the tree-shaker can prune it.
`flocks_mcp` · pub.dev	The component catalog served to agents over MCP. Also on the MCP Registry and as an `.mcpb` bundle in each release.
`flocks_demo` · flocks.live/demo · not published, by design	The white-label demo: your brand colour on a full dashboard and CRUD, and the configuration exported as Dart you can paste. It is a showcase, not a library.

No version numbers in that table on purpose: nothing here gates a hand-written one, and pub.dev already shows the current version of each.

Start at packages/flocks/README.md. The components are browsable at widgetbook.flocks.live.

Working on it

This repo is a pub workspace. Resolve from the root, always:

bash

flutter pub get

That is what makes the adapters and the MCP server resolve flocks against the local package instead of the published one, so a change to the core is felt by them in the same checkout. Each package carries resolution: workspace, so pub get run inside one of them will fail — it is not a broken checkout.

bash

dart format --output=none --set-exit-if-changed .   # formatação
dart analyze                                        # os três pacotes
cd packages/flocks && flutter test --exclude-tags golden
cd packages/flocks && dart run tool/validate_components.dart

Goldens compare pixels and their baselines were generated on macOS arm64, so they run apart, and only there:

bash

cd packages/flocks && flutter test --tags golden

License

MIT — see LICENSE. Bundled third-party assets keep their own licenses: the fonts are SIL Open Font License 1.1, Phosphor Icons is MIT, Lucide is ISC (with the part derived from Feather under its own MIT), and cupertino_icons — a dependency, not a vendored asset — is MIT. Each license text ships beside the files it covers (OFL.txt, assets/icons/LICENSE, assets/fonts/LICENSE-phosphor-*, packages/flocks_lucide/assets/fonts/LICENSE-lucide), and each package's README says which apply to it.