Skip to main content
196

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
All documentation
Design handoff

One system from canvas to code.

Design and implementation share one semantic language. Explore variables, component variants, and handoff patterns that map directly to Lumen code.

brandPrimary interaction

surfaceRaised content

successPositive state

Plugin version
1.1.0
Web / native components
21 / 12
Export targets
7

Design files on Figma Community

Lumen UI Library v5

Design with shared components, variables, and six themes in light and dark modes.

Lumen Templates

Adapt six desktop and mobile layouts, including dashboards, onboarding, and editorial pages.

Lumen Playgrounds

Compare web examples with screens for React Native, SwiftUI, and Jetpack Compose.

Lumen for Figma

Local build

Select a design built with Lumen, inspect its components, and take a web or native starter into your project. The AI handoff gives your coding agent the selected structure, component properties, semantic color references, and items that need review.

Web export recognizes 21 components by their canonical library keys, including form controls, CodeTabs, Prose, Timeline and RevealGroup. Detached components and custom layers appear in the review findings.

Choose your framework and Lumen release. Lumen 5.0.0 offers selective styles, including Paper and Field. Lumen 4.4.0 uses the full stylesheet and pairs Astro 4.4.0 with React and Elements 4.3.0. Copy the setup alongside the starter to load the styles and behavior for your framework.

For native code, select React Native or Android Compose (adapter 4.1.0), or SwiftUI for iPhone or Mac (Swift package v5.0.0). All four targets support twelve components, including labeled inputs, checkboxes, progress and nested layouts. They use the app’s theme and list unsupported layers in the handoff. Check package or tag availability before installing a target version.

bash
pnpm install --frozen-lockfile
pnpm exec turbo run build --filter=@santi020k/lumen-figma-plugin

In Figma desktop, choose Plugins → Development → Import plugin from manifest and select apps/figma-plugin/dist/manifest.json. Run these build commands from the Lumen repository root. The plugin is not yet published to Figma Community; the links above open the published design files.

Select one frame or component instance. In Setup, choose the export target, version and project appearance, then choose Inspect selection. Check the findings in Design review and choose Open handoff. Copy the app setup and copy or save the starter or AI handoff. Exports include the selected design's visible text and component data, so review them before sharing with your coding agent. Changes to the selection or export settings require a fresh inspection.

Community publication follows the Lumen v5 package and documentation release. An install link will appear here after Figma approval and verified public installation.

Setup and component coverage

Inside the file

Built for useful handoff

The library is intentionally compact: foundations establish the contract, components demonstrate it, and the codebase remains the source of truth for behavior.

Variables

Semantic colors, radius, and effects connect component appearance to shared design decisions.

Library pages

Cover, Foundations, and Components keep the design file easy to scan during handoff.

Component variants

Core variants mirror code props where possible, so review language remains consistent.

Code workflow

Use Code Connect mappings and the plugin to bring Lumen components into a web or native handoff.

Recommended flow

Design with the contract

A short loop keeps visual decisions traceable from the first frame through production.

  1. 01

    Start with semantics

    Choose canvas, surface, ink, brand, and state tokens before reaching for raw color values.

  2. 02

    Compose with variants

    Use library components and their variants to keep behavior and naming close to production.

  3. 03

    Hand off by contract

    Reference component names, props, and semantic tokens—the same vocabulary engineers use in code.

All documentationWeb and native guides