fabrik_theme

A lightweight, opinionated theming foundation for Flutter applications.

fabrik_theme helps you define and consume colors, typography, and design tokens in a consistent, scalable, and predictable way, without mixing UI widgets, layout concerns, or responsiveness into the theming layer.

This package focuses on fundamentals and stays intentionally small.

Learn more

Detailed documentation, guides, and rationale are available at
fabriktool.com

Overview

The goal of fabrik_theme is to provide a clear design language layer for Flutter apps.

It encourages:

  • Semantic colors and typography
  • Centralized theme construction
  • Predictable usage in widgets
  • Strong separation between design tokens and UI components

What this package provides

Design tokens

Static, context-independent values that describe your design system:

  • ColorTokens
  • TypographyTokens
  • SpacingTokens
  • RadiusTokens
  • BorderTokens
  • ElevationTokens

Tokens are accessed directly and never depend on BuildContext.

Padding(
  padding: EdgeInsets.all(SpacingTokens.md),
)

Semantic theme extensions

Design semantics are expressed using ThemeExtensions:

  • AppColors
  • AppTypography

These are resolved once during theme creation and then consumed by widgets.

Text(
  'Profile',
  style: context.typography.titleMedium,
)

Builders

Builders compose raw tokens into usable theme data.

  • FabrikTypographyBuilder resolves typography using colors and font family
  • FabrikTheme wires everything into ThemeData

Widgets never perform theme composition.

Installation

dependencies:
  fabrik_theme: ^1.0.0

Basic usage

Define your colors

class AppThemeColors {
  static const light = AppColors(
    primary: Color(0xFF6C5CE7),
    accent: Color(0xFF00CEC9),
    textPrimary: Color(0xFF111111),
    textSecondary: Color(0xFF444444),
    textTertiary: Color(0xFF777777),
    background: Color(0xFFFFFFFF),
    surface: Color(0xFFF6F6F6),
    divider: Color(0xFFE0E0E0),
  );

  static const dark = AppColors(
    primary: Color(0xFFB4A7FF),
    accent: Color(0xFF55EFC4),
    textPrimary: Color(0xFFFFFFFF),
    textSecondary: Color(0xFFCCCCCC),
    textTertiary: Color(0xFF999999),
    background: Color(0xFF121212),
    surface: Color(0xFF1E1E1E),
    divider: Color(0xFF2C2C2C),
  );
}

Create a theme

MaterialApp(
  theme: FabrikTheme.create(
    brightness: Brightness.light,
    colors: AppThemeColors.light,
    fontFamily: 'Inter',
  ),
  darkTheme: FabrikTheme.create(
    brightness: Brightness.dark,
    colors: AppThemeColors.dark,
    fontFamily: 'Inter',
  ),
);

Typography is generated automatically unless explicitly provided.

Using colors and typography

Colors

Container(
  color: context.colors.surface,
)

Typography

Text(
  'Settings',
  style: context.typography.titleMediumPrimary,
)

Typography variants are semantic.
For one-off cases, copyWith is fully supported.

Typography philosophy

fabrik_theme avoids mechanical permutations.

Instead, it provides:

  • Primary variants for display, headlines, and titles
  • Secondary and tertiary variants for body text
  • Emphasis variants where weight-based emphasis is common

If a styling pattern repeats across the app, it belongs in the system.
If it is contextual, copyWith is appropriate.

Opinionated boundaries

This package intentionally does not include:

  • Responsive scaling or breakpoints
  • Context-based spacing
  • Layout or UI widgets
  • Component abstractions

These decisions keep the theming layer stable and predictable.

Responsiveness, layout helpers, and components are expected to live in separate packages.

Extensibility

fabrik_theme is designed to be extended, not forked.

You can:

  • Add your own ThemeExtensions
  • Build component libraries on top of the tokens
  • Layer responsive systems above it
  • Replace typography entirely if needed

The package does not lock you into a closed system.

Documentation

This README covers the essentials.

Detailed documentation and examples are available at
fabriktool.com

Closing note

fabrik_theme is intentionally boring in the best way possible.

It favors clarity over cleverness and stability over convenience.
If you value maintainable UI code, this package is built for you.

Libraries

fabrik_theme