formds_tokens

Audience: Consumer (Flutter app teams)
Owner: FormDS maintainers
Source of truth: This README (candidate for future Zeroheight migration)

formds_tokens provides generated FormDS token constants for Flutter, split by brand and light/dark mode. Pick a brand, import a mode, and you are ready to theme UI components quickly.

Features

Brand and semantic colors as Color values
Spacing, radii, and sizing values as numeric constants
Separate light/dark token classes per brand
Raw JSON token assets in assets/json/

Installation

Install from pub.dev:

dependencies:
  formds_tokens: ^0.1.0

For alpha/nightly channels, use a pre-release version:

x.y.z-alpha.n
x.y.z-nightly.timestamp

Usage

Example: Altibox, light mode

import 'package:formds_tokens/altibox_light.dart';

final primary = AltiboxLight.brandColorInteractivePrimaryBase; // Color
final radius = AltiboxLight.brandBorderDefault; // double

Example: Konsern, dark mode

import 'package:formds_tokens/konsern_dark.dart';

final bg = KonsernDark.brandColorBackgroundBase;

Which Import Should I Pick?

If your UI is light mode: import <brand>_light.dart
If your UI is dark mode: import <brand>_dark.dart
If your app supports both: switch imports/usages based on your theme mode

Brands and Themes

Current brand entrypoints:

altibox_light.dart / altibox_dark.dart
form_light.dart / form_dark.dart
konsern_light.dart / konsern_dark.dart
lyse_light.dart / lyse_dark.dart

You can import the mode-specific file your app needs per runtime theme.

Token Layer Model

The generated values come from the same token layer stack used across platforms:

primitive -> theme -> responsive -> brand

Higher layers can reference values from their own layer or lower layers.

Package Layout

Public entrypoints:

lib/<brand>_<light|dark>.dart

Generated internals:

lib/src/<brand>/<light|dark>/tokens_style_dictionary.dart

JSON assets:

assets/json/**

Versioning and Channels

Token releases are tagged in the repository and published to pub.dev:

tokens-v<version> (stable)
tokens-v<version>-alpha.<n>
tokens-v<version>-nightly.<timestamp>

Tag and package versions match (tokens-v2.0.0-alpha.1 publishes as 2.0.0-alpha.1).

Maintainers

Token sync/release pipeline docs:

docs/tokens/local-development.md
docs/tokens/release.md

For issues or contributions, see the repository at formds-figma-exporter.