XProject Generator

XProject Generator is a command-line tool and library to scaffold Flutter applications and feature modules using opinionated, production-ready templates. It supports GetX, Riverpod, and Bloc (simple or clean) and automates common setup tasks such as environment files, flavors, localization, and example features.

Key features

Interactive project creation with prompts for app name, package IDs, Firebase, state management, and architecture (where applicable)
Generate feature templates inside an existing project (GetX, Riverpod, or Bloc)
Create environment files (.env.*) and platform flavor configuration (Android & iOS)
Optional Firebase initialization helpers and platform config templates
Templates for themes, text style, app colors, localization, base API connection, sessions, and example features

Repository layout (important files)

bin/xproject.dart — CLI entrypoint
lib/xproject_generator.dart — interactive project generator
lib/xfeature_generator.dart — feature generator for existing projects
lib/src — generators and template code
- lib/src/templates — template implementations for GetX, Riverpod, and Bloc
pubspec.yaml

Installation

From pub.dev (recommended)

# Install globally from pub.dev:
dart pub global activate xproject_generator
#
# (Optional) Install a specific version:
dart pub global activate xproject_generator 1.2.3

# Run the CLI (executable is `xproject`):
xproject --help

Usage

Create a new project (interactive):

# Interactive: prompts for project name, package IDs, Firebase, and state management
xproject
# Or explicitly
xproject create

Add a new feature to an existing Flutter project:

# Generates feature templates inside the current Flutter project
xproject --feature authentication
# Short option
xproject -f authentication

Show version/help

xproject --version
xproject --help

What the generators do

ProjectGenerator:
Prompts for app display name, project name (snake_case), Android package, iOS bundle id, Firebase usage, and state management (GetX, Riverpod, or Bloc).
For Riverpod and Bloc, you can choose an architecture:
- Simple: fewer layers, direct datasource usage
- Clean Code: includes domain/repository/usecase layers
Runs flutter create, updates pubspec.yaml with selected dependencies, creates folders and template files, creates .env.* placeholders, and writes recommended .vscode tasks/launch configs.
FeatureGenerator:
Detects state management by inspecting pubspec.yaml and scanning lib/ for common usage indicators (e.g., GetMaterialApp, GoRouter, BlocProvider).
Detects architecture by checking for domain or data/repositories folders.
Generates feature files and folders under lib/features/<feature> using templates for the detected state management + architecture.
- Runs dart run build_runner build --delete-conflicting-outputs after generation to produce generated code artifacts.

Templates

Templates live in the repository under lib/src/templates and include:

common_templates.dart — shared snippets (theme, env helpers, app widget, firebase helpers)
getx/ — GetX-specific feature and app templates
riverpod/ — Riverpod-specific feature and app templates (simple & clean)
bloc/ — Bloc-specific feature and app templates (simple & clean)

Post-creation steps

Change directory into the newly created project:

cd <your_project_name>
flutter pub get

If you enabled Firebase, add your platform files:

android/app/google-services.json
ios/Runner/GoogleService-Info.plist

Run build_runner to generate code for freezed/riverpod generators (if used):

flutter pub run build_runner build --delete-conflicting-outputs

Example

CLI quick-start (interactive)

# Start interactive project creation
xproject

# Explicit create command
xproject create

# Add a feature to an existing Flutter project
xproject --feature authentication
# Short option
xproject -f authentication

# Show version/help
xproject --version
xproject --help

Non-interactive (one-liners)

# Create a new project with explicit arguments (if supported by your CLI version)
xproject create

# Generate a feature (state management is auto-detected)
xproject --feature auth

Note: When creating a new project the CLI will prompt you to choose a state
management option (Bloc, GetX, Riverpod). For Riverpod and Bloc you will also
select an architecture (Simple or Clean Code). When generating features, state
management and architecture are detected automatically based on your project's
dependencies and folder structure.

Programmatic usage (Dart)

The library can also be used directly from Dart code. The following example shows basic usage of the ProjectGenerator and FeatureGenerator APIs (illustrative):

import 'package:xproject_generator/xproject_generator.dart';
import 'package:xproject_generator/xfeature_generator.dart';

Future<void> main() async {
  // Create a new project (interactive by default)
  final projectGen = ProjectGenerator();
  await projectGen.create();

  // Add a feature programmatically to an existing project
  final featureGen = FeatureGenerator();
  await featureGen.add('authentication');
}

What a generated project contains

lib/ and lib/features/<feature>/ (views, controllers/notifiers, bindings/providers)
.env.development, .env.production placeholder files
Platform flavor configuration for Android and iOS
.vscode tasks and launch helpers for common workflows

Post-generation quick steps

cd <your_project_name>
flutter pub get
# If using codegen (freezed/riverpod):
flutter pub run build_runner build --delete-conflicting-outputs

Contributing

Contributions are welcome. Keep changes small and focused. Please open issues for bugs or feature requests and send pull requests for improvements to templates or tooling.

XProject Generator

Libraries

xproject_generator package