README

UI Designer

Dev-only DTCG theme designer for UI Kernel

Note

Read-only mirror. See CONTRIBUTING.md for how to propose changes.

Features

• DTCG-native authoring — W3C design tokens + theme.meta.yaml; no legacy YAML pack format
• Visual studio — /ui-designer with ref picker, contrast panel, undo, and snapshots
• Import engines — shadcn registry, W3C, Tokens Studio, Figma variables
• Session preview — kernel gallery deep link without mutating the theme registry
• Export packs — validated DTCG trees under config/themes/{lineage}/
• Dev-only forever — Flex recipe registers bundle for dev and test only

Prerequisites

Add the symfinity/recipes Flex endpoint to your project's composer.json (see recipes README).

Requires symfinity/ui-kernel ^0.3.1.

Installation

composer require --dev symfinity/ui-designer

The Flex recipe applies OOTB — bundle + config/packages/symfinity_ui_designer.yaml. Do not enable in production.

Quick Start

With APP_ENV=dev, open /ui-designer. See Quickstart.

Documentation

• Quickstart — first authoring loop
• Installation — Flex OOTB, prod guardrails
• Configuration — export root, undo, snapshots
• Commands — ui-designer:* CLI
• Upgrade — 0.1.0 release notes
• Roadmap — 0.1.x–1.0.x milestones
• Verification — clean-app smoke (P0 profile)

Requirements

• PHP 8.2 or higher
• Symfony 7.4 or 8.x
• symfinity/ui-kernel ^0.3.1

Support

• GitHub Issues
• Security
• Contributing

License

MIT