Quick Start — Install, Configure, Build
This guide takes you from zero to a working token build in under 10 minutes. You will install the Aplica Theme Engine package, scaffold a consumer workspace, and produce your first dist/ output.
Consumer Workspace Structure
The Aplica Theme Engine follows a core + consumer model. The package owns the generation engine; your project owns the configuration, the generated data, and the final build output.
Theme Configuration
Theme configuration lives in theme-engine/config/. These files define what the engine generates — brand colors, typography, modes, and spacing scales. The engine reads them; your project versions them.
Transformers Configuration
The transformers configuration controls how the engine converts data/ into dist/. It defines which token layers to build, which output platforms to generate, and where each output file goes.
CLI Reference
The aplica-theme-engine CLI is the primary interface for generating and building design tokens. All commands run against the current consumer workspace — the engine reads your configuration from aplica-theme-engine.config.mjs and writes all output inside your project root.
Build and CI/CD Integration
This article covers the recommended package.json scripts, build strategies for different team workflows, and how to integrate token generation into a CI/CD pipeline.
Troubleshooting
This article covers common errors and how to resolve them, organized by the stage where they appear.