Flutter Carbon registry

Application-owned Carbon source for Remix. This repository owns the carbon preset separately from the official Remix registry. It is not a remix_carbon runtime package: the Remix CLI copies the selected theme and component source into each application.

The initial catalog contains theme and button. The theme includes Carbon white, Gray 10, Gray 90, and Gray 100, with a pinned IBM token provenance manifest. The Button depends on the theme and generates its Mix adapter in the consumer application. Charts, a full icon package, native Carbon widgets, and Agent/dashboard surfaces are not in this first catalog.

Install from the published registry

Once the public btwld/flutter-carbon repository has a promoted stable branch and a Remix CLI release with the Carbon default source:

flutter pub add dev:remix_cli
dart run remix_cli:remix init --prefix Acme --preset carbon
dart run remix_cli:remix add button

The CLI resolves stable to a full commit SHA in remix.yaml. A later remix registry update @carbon moves that pin; remix add button --diff previews changes to the source the application owns. The registry is public because the CLI currently supports only public GitHub sources.

Repository layout

Path	Responsibility
registry_source/lib/src/carbon/	Analyzer-checked authored theme and Button.
registry_source/tool/carbon/	Pinned IBM token pipeline, lock, and verifier.
registry_source/test/carbon/	Foundation and widget tests.
tool/dependency_floors.json	Installed package constraint floors.
tool/build_registry.dart	Deterministic publisher and drift gate.
registry/	Derived schema-1 index, schema-2 catalog, and templates.
consumer_fixture/	Pre-install app and tests for the exact-commit smoke.

Local verification

Use the committed Flutter 3.44.0 toolchain:

cd registry_source
fvm flutter pub get
fvm flutter analyze
fvm flutter test --reporter=failures-only
cd ..
npm --prefix registry_source/tool/carbon run tokens:verify
fvm dart tool/build_registry.dart --check

To intentionally refresh derived output after an authoring change, run fvm dart tool/build_registry.dart and review the resulting diff. Do not hand-edit registry/. CI verifies output drift, source tests, dependency floors, and token provenance. Promotion runs an additional fresh-consumer smoke against the exact pushed candidate commit before fast-forwarding stable; a failed check leaves existing pins untouched.

The runbook describes ownership and release order. The component map is the later-work roadmap.

Attribution

This is an independent community implementation, not endorsed by IBM. Carbon source material and tokens retain their pinned provenance in the generated source and NOTICE. IBM Plex is not bundled; applications that add it must follow its SIL Open Font License. “IBM”, “Carbon”, and “IBM Plex” are IBM trademarks. The repository and Carbon-derived source are Apache-2.0; see LICENSE.