Search packages, repositories and app categories

Package detailsv1.0.0

lumen_ui

Lumen UI is a CLI tool for Flutter that generates modular UI components on demand to keep apps lightweight and maintainable.

AndroidiOSmacOSWindowsLinux
30-day downloads
24
Likes
2
Pub points
130

Install package

flutter pub add lumen_ui

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

Lumen UI is a CLI tool for Flutter that automates the generation of modular, reusable UI components. It helps developers maintain lightweight and scalable apps by creating well-structured widgets on demand. The tool integrates seamlessly with Flutter projects and supports multiple platforms, ensuring consistent UI across Android, iOS, macOS, Windows, and Linux. By promoting modularity, Lumen UI enhances code organization and reduces redundancy in UI development.

Use cases

  • Rapid UI prototyping
  • Maintaining consistent design systems
  • Reducing boilerplate code
  • Scaling large Flutter applications
  • Automating component creation

Key features

  • CLI-driven component generation
  • Modular and reusable widget templates
  • Cross-platform support
  • Lightweight output
  • Integration with Flutter pub package system

Suitable for

  • Flutter teams prioritizing maintainability
  • Developers building design-heavy apps
  • Projects requiring rapid UI iteration
  • Teams using component-based architecture
  • Frontend-focused Flutter developers

Considerations

  • Requires familiarity with CLI workflows
  • May need customization after generation
  • Depends on stable Flutter environment
  • Best used in structured project setups
  • Not a runtime library but a development tool

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Lumen UI

A CLI-based Flutter package for generating modular, customizable UI components on demand.

Motivation

Flutter developers often struggle with bloated UI component libraries that increase app size and affect performance. Lumen UI CLI solves this by providing a command-line tool that generates only the components you need, with full customization options.

Features

  • Modular UI component generation
  • Customizable component templates
  • Theme and style configuration options
  • Material Design and Cupertino guideline compliance
  • Inline documentation for generated components

Full Documentation

For complete knowledge about the package, please visit the official documentation website:

Lumen UI Documentation

Installation

Follow these steps to set up your Flutter project and integrate Lumen UI:

1. Create a New Flutter Project

Using Flutter CLI
 flutter create my_app
 cd my_app
Using VS Code
  1. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
  2. Type "Flutter: New Project"
  3. Select "Application"
  4. Choose project directory
  5. Name your project
Using Android Studio
  1. Click "New Flutter Project" from welcome screen
  2. Select Flutter project type
  3. Configure project settings
  4. Click "Finish"

📚 New to Flutter? Check out the official Flutter documentation for detailed setup instructions.

2. Add Lumen UI to Your Project

Add this line to your pubspec.yaml under dependencies:

dev_dependencies:
  flutter_test:
    sdk: flutter
  lumen_ui: 0.0.1 # Add Lumen UI package

3. Install Dependencies

Run this command in your project directory:

flutter pub get

4. Verify Installation

Run this command to verify the installation:

flutter pub list

You should see lumen_ui: 1.0.0 in the list of installed packages.


🎉 Congratulations! You're now ready to use Lumen UI in your Flutter project.

Continue to the Usage section to learn how to implement Lumen UI components.

Usage

dart run lumen_ui [options]
Options
Option Alias Description Required
--type -t Type of component to generate Yes
--name -n Name of the component Yes
--output -o Output directory (defaults to lib/ui) No
--help -h Show help information No
--version -v Show version information No
--verbose - Enable verbose logging No
Component Types
  • button: Button components
  • dummy: Dummy components for testing
Component Naming Rules
  • Must start with a letter
  • Can contain letters, numbers, and underscores
  • Cannot contain spaces or special characters

Examples

List all supported types and their related UIs:

dart run lumen_ui --list

List all supported component types:

dart run lumen_ui --list-types

List related UIs for a specific component type:

dart run lumen_ui --list-uis button

Generate a primary button:

dart run lumen_ui -t button -u primarybutton -n primary

Generate with custom output directory:

dart run lumen_ui -t button -u iconbutton -n iconbtn -o lib/components 

Output Structure

Components are generated in the following structure:

lib/ui/
  ├── buttons/
  │   └── primary_button
        └── primary_button.dart
  └── styles/
      └── color.dart
      └── styles.dart

Error Handling

Common error messages and solutions:

  • Both --type, --ui and --name are required: Ensure both -t, -u and -n options are provided
  • Invalid component name: Follow the component naming rules
  • Error parsing arguments: Check the command syntax
  • Invalid argument format: Verify option values are correct

Additional Commands

Show help:

dart run lumen_ui --help

Show version:

dart run lumen_ui --version

Architecture

The project follows a Layered Architecture pattern with:

  • HMI Layer: Command-line interface
  • Service Layer: Component generation and template services
  • Application Layer: Core business logic
  • Communication Layer: File system operations

Technology Stack

  • Dart SDK (>=2.18.0)
  • Flutter SDK (>=3.0.0)
  • Development Tools: VS Code, Android Studio
  • CLI Framework: args/cli_util

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

Requirements

  • Processor: Intel Core i5 or equivalent
  • RAM: 8GB minimum (16GB recommended)
  • Storage: 500GB SSD
  • Operating Systems: Windows, macOS, or Linux

License

MIT License

Authors

Categories

Dependencies

Dependency list 4 items

Source repository

Projects using this package

No data available yet.