Home

Welcome to layrz_ui, a Material-free, Cupertino-free Flutter design system built exclusively on package:flutter/widgets.dart and dart:ui. It replaces layrz_theme with a clean-break rewrite featuring improved modularity, zero Material dependency, and a token-based semantic design approach.

---

Getting Started

New to layrz_ui? Start here:

• Getting Started — Add the dependency, set up LayrzApp, preload fonts, and build your first screen
• LayrzApp — The root widget and its complete API reference
• Theming — How the theme system works and how to access design values in widgets

---

Foundation Reference

Core design system documentation:

• Design Tokens — Complete reference of all colors, typography, spacing, radius, shadows, borders, and motion tokens
• LayrzTokenizer — Facade for accessing tokens via group getters and flat shortcuts
• Fonts — Font setup, preloading, and customization (Open Sans by default)
• Widget States — Interactive state management for buttons, inputs, and other controls
• Platform and Extensions — Platform detection and convenience utilities for colors and BuildContext
• Theme Extensions — How to create and use custom theme extensions for component-specific data
• Widget Previews — Using @Preview annotations with LayrzPreviewTheme to preview widgets in your IDE

---

Component Reference

All widget documentation is available in the Widget Reference. Check the sidebar on that page for the complete list of components organized by category.

---

Engineering Documentation

For architecture, design decisions, dependencies, roadmap, and audit details, see the engineering documentation in the repository.

Progress is tracked in the GitHub Project for layrz_ui, not in these wiki pages.