fli #

A powerful CLI tool for generating clean and standardized Flutter project structures.

🚀 Why fli? #

Every Flutter developer has faced this problem: inconsistent project structures across different projects and teams. fli solves this by providing:

• Standardized Structure: Clean, organized folder structures that scale
• Multiple Templates: Choose from various architectural patterns
• Best Practices: Built-in Flutter and Dart best practices
• Developer Friendly: Simple commands, interactive prompts
• Extensible: Easy to customize and extend

📦 Installation #

Option 1: Install from pub.dev (Recommended) #

dart pub global activate fli

Option 2: Install from source #

git clone https://github.com/faizahmaddae/fli.git
cd fli
dart pub global activate --source path .

Option 3: Quick install script #

curl -fsSL https://raw.githubusercontent.com/faizahmaddae/fli/main/install.sh | bash

Note: Make sure ~/.pub-cache/bin is in your PATH to use fli directly.

🛠️ Usage #

Generate a new Flutter project with clean structure #

fli create my_app

Interactive mode with options #

fli create my_app --interactive

Choose a specific template #

fli create my_app --template=clean_architecture

Available templates #

• basic - Simple, clean structure for small to medium apps
• feature_driven - Feature-based organization
• clean_architecture - Clean Architecture with proper separation
• bloc_pattern - BLoC pattern implementation
• provider_pattern - Provider state management structure

🏗️ Generated Structure Example #

my_app/
├── lib/
│   ├── core/
│   │   ├── constants/
│   │   ├── errors/
│   │   ├── theme/
│   │   └── utils/
│   ├── features/
│   │   └── home/
│   │       ├── data/
│   │       ├── domain/
│   │       └── presentation/
│   ├── shared/
│   │   ├── widgets/
│   │   └── services/
│   └── main.dart
├── test/
├── assets/
│   ├── images/
│   ├── icons/
│   └── fonts/
└── docs/

🎯 Commands #

• fli create <project_name> - Create a new Flutter project
• fli templates - List available templates
• fli --help - Show help information
• fli --version - Show version

🤝 Contributing #

We welcome contributions! Please feel free to submit issues and pull requests.

📄 License #

MIT License - see LICENSE file for details.