🚀 AppForge CLI #

A powerful command-line tool to generate production-ready Flutter applications with pre-configured architecture, authentication, theming, and Firebase integration.

👆 Click to watch the demo video

✨ Features #

🎨 Beautiful Themes #

• 5 pre-built color schemes (Blue, Green, Coffee, Purple, Orange)
• Complete light & dark mode support
• Material 3 design system
• Responsive layouts for phones and tablets

🔐 Multiple Authentication Methods #

• Email & Password - Traditional auth with validation
• Username & Password - Username-based authentication
• Phone & OTP - SMS verification with 6-digit OTP
• Social Auth - Google & Apple Sign-In
• All Methods - Unified auth interface with all options

🔥 Modular Firebase Integration #

• Authentication - Sign up, sign in, profile management
• Cloud Firestore - Complete CRUD operations with real-time streams
• Cloud Storage - File upload/download with progress tracking
• Cloud Messaging - Push notifications with FCM
• Automatic flutterfire configure setup

🧩 12+ Reusable Widgets #

• Custom App Bar & Bottom Navigation
• Loading indicators (3 types)
• Info, Image, and Action Cards
• Primary, Secondary, and Icon Buttons
• Empty & Error States
• Custom Input Fields & Search
• Dialog & Snackbar Helpers
• List Tiles, Avatars, and Badges

🏗️ Clean Architecture #

• Feature-based folder structure
• Separation of concerns
• Scalable and maintainable codebase
• Go Router for navigation
• State management (Provider, Riverpod, or Bloc)

📱 Ready-to-Use Screens #

• Splash Screen with animations
• Home Screen with stats and quick actions
• Profile Screen with settings
• Login/Signup screens (based on auth type)
• All screens are responsive and themed

� Screenshots #

�📦 Installation #

Prerequisites #

• Dart SDK (>=3.5.0)
• Flutter SDK
• Firebase CLI (optional, for Firebase features)

Install from pub.dev #

dart pub global activate appforge_cli

Or install from source #

git clone https://github.com/appforge-cli/appforge_cli.git
cd appforge_cli
dart pub get
dart pub global activate --source path .

Verify Installation #

After installation, verify that AppForge CLI is properly installed:

appforge --version

You should see:

appforge_cli version: 0.1.3

Or simply run:

appforge

╔═════════════════════════════════════════════════════════════════════╗
║                                                                     ║
║  █████╗ ██████╗ ██████╗ ███████╗ ██████╗ ██████╗  ██████╗ ███████╗  ║
║ ██╔══██╗██╔══██╗██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝  ║
║ ███████║██████╔╝██████╔╝█████╗  ██║   ██║██████╔╝██║  ███╗█████╗    ║
║ ██╔══██║██╔═══╝ ██╔═══╝ ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝    ║
║ ██║  ██║██║     ██║     ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗  ║
║ ╚═╝  ╚═╝╚═╝     ╚═╝     ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝  ║
║                                                                     ║
║                      ██████╗██╗     ██╗                             ║
║                     ██╔════╝██║     ██║                             ║
║                     ██║     ██║     ██║                             ║
║                     ██║     ██║     ██║                             ║
║                     ╚██████╗███████╗██║                             ║
║                      ╚═════╝╚══════╝╚═╝                             ║
╚═════════════════════════════════════════════════════════════════════╝

If you see this, your installation is complete! 🎉

Troubleshooting:

• If appforge command is not found, make sure Dart's global bin directory is in your PATH
• Run dart pub global list to verify appforge_cli is activated
• Restart your terminal after installation

🚀 Quick Start #

Interactive Mode #

appforge create

Follow the prompts to configure your app:

1. Project Name - Enter your app name
2. State Management - Choose between Provider, Riverpod, or Bloc
3. Theme Color - Select from 5 beautiful themes
4. Authentication Type - Pick your auth method
5. Firebase - Enable and select Firebase modules

Non-Interactive Mode #

appforge create \
  --name my_awesome_app \
  --org com.mycompany \
  --state riverpod \
  --theme blue \
  --firebase

With Flags #

# Short flags
appforge create -n my_app -s bloc -t coffee -f

# Full options
appforge create \
  --name my_app \
  --org com.example \
  --state provider \
  --theme purple \
  --firebase \
  --yes

🎯 Usage Examples #

Example 1: E-commerce App with Firebase #

appforge create

# Selections:
# Name: shop_app
# State: riverpod
# Theme: blue
# Auth: email_password
# Firebase: Yes
#   - auth
#   - firestore
#   - storage

Generated structure:

shop_app/
├── lib/
│   ├── app/
│   │   ├── router/
│   │   └── theme/
│   ├── features/
│   │   ├── auth/
│   │   ├── home/
│   │   └── profile/
│   ├── shared/
│   │   └── widgets/        # 12+ reusable widgets
│   ├── core/
│   │   └── firebase/       # Complete Firebase CRUD
│   └── main.dart
└── pubspec.yaml

Example 2: Social Media App #

appforge create -n social_app -s bloc -t purple
# Auth: all (email, username, phone, social)
# Firebase: Yes (all modules)

Example 3: Simple Utility App #

appforge create -n util_app -s provider -t green
# Auth: email_password
# Firebase: No

📁 Generated Project Structure #

your_app/
├── lib/
│   ├── app/
│   │   ├── router/
│   │   │   └── app_router.dart           # Go Router configuration
│   │   ├── theme/
│   │   │   └── app_theme.dart            # Light & Dark themes
│   │   └── di/                            # Dependency injection
│   ├── features/
│   │   ├── app/
│   │   │   └── screens/
│   │   │       └── splash_screen.dart
│   │   ├── auth/
│   │   │   ├── screens/
│   │   │   │   ├── login_screen.dart
│   │   │   │   ├── signup_screen.dart
│   │   │   │   └── otp_verification_screen.dart
│   │   │   ├── widgets/
│   │   │   └── services/
│   │   ├── home/
│   │   │   └── screens/
│   │   │       └── home_screen.dart
│   │   └── profile/
│   │       └── screens/
│   │           └── profile_screen.dart
│   ├── shared/
│   │   ├── widgets/
│   │   │   ├── widgets.dart              # Barrel file
│   │   │   ├── custom_app_bar.dart
│   │   │   ├── custom_bottom_nav_bar.dart
│   │   │   ├── loading_indicators.dart
│   │   │   ├── custom_cards.dart
│   │   │   ├── custom_buttons.dart
│   │   │   ├── empty_states.dart
│   │   │   ├── custom_input_fields.dart
│   │   │   ├── dialog_helper.dart
│   │   │   ├── snackbar_helper.dart
│   │   │   ├── custom_list_tiles.dart
│   │   │   ├── custom_avatar.dart
│   │   │   └── custom_badge.dart
│   │   ├── services/
│   │   ├── utils/
│   │   └── constants/
│   ├── core/
│   │   ├── firebase/
│   │   │   └── firebase_operations.dart  # Complete Firebase CRUD
│   │   ├── errors/
│   │   ├── network/
│   │   └── storage/
│   └── main.dart
├── test/
│   └── widget_test.dart
├── pubspec.yaml
└── README.md

🎨 Available Themes #

🔐 Authentication Types #

Email & Password #

await FirebaseOperations.signUpWithEmail(
  email: '[email protected]',
  password: 'password123',
);

Phone & OTP #

// Send OTP
context.push('/otp-verification', extra: phoneNumber);

// Verify OTP
await FirebaseOperations.verifyOTP(code: '123456');

Social Auth #

await FirebaseOperations.signInWithGoogle();
await FirebaseOperations.signInWithApple();

🔥 Firebase Operations #

Firestore CRUD #

// Create
final docId = await FirebaseOperations.createDocument(
  collection: 'users',
  data: {'name': 'John', 'age': 30},
);

// Read
final data = await FirebaseOperations.readDocument(
  collection: 'users',
  documentId: docId,
);

// Update
await FirebaseOperations.updateDocument(
  collection: 'users',
  documentId: docId,
  data: {'age': 31},
);

// Delete
await FirebaseOperations.deleteDocument(
  collection: 'users',
  documentId: docId,
);

// Real-time Stream
StreamBuilder(
  stream: FirebaseOperations.streamCollection(
    collection: 'messages',
    orderBy: 'timestamp',
  ),
  builder: (context, snapshot) {
    // Build your UI
  },
)

Storage Operations #

// Upload file
final url = await FirebaseOperations.uploadFile(
  file: imageFile,
  path: 'users/$userId/profile.jpg',
  onProgress: (progress) {
    print('Upload: ${(progress * 100).toInt()}%');
  },
);

// Download file
final file = await FirebaseOperations.downloadFile(
  path: 'users/$userId/profile.jpg',
  localPath: '/path/to/save/image.jpg',
);

// Delete file
await FirebaseOperations.deleteFile(
  path: 'users/$userId/old_profile.jpg',
);

Cloud Messaging #

// Initialize
await FirebaseOperations.initializeFCM();

// Get token
final token = await FirebaseOperations.getFCMToken();

// Subscribe to topic
await FirebaseOperations.subscribeToTopic(topic: 'news');

// Handle messages
FirebaseOperations.handleForegroundMessages((message) {
  print('New message: ${message.notification?.title}');
});

🧩 Using Reusable Widgets #

Import #

import 'package:your_app/shared/widgets/widgets.dart';

Examples #

// Custom App Bar
CustomAppBar(
  title: 'My Screen',
  actions: [
    IconButtonCustom(icon: Icons.search, onPressed: () {}),
  ],
)

// Info Card
InfoCard(
  title: 'Total Sales',
  value: '\$12,345',
  icon: Icons.attach_money,
  color: Colors.green,
)

// Primary Button
PrimaryButton(
  text: 'Submit',
  isLoading: isLoading,
  onPressed: () {},
)

// Snackbar
SnackBarHelper.showSuccess(context, 'Saved successfully!');

// Dialog
await DialogHelper.showConfirmDialog(
  context,
  title: 'Delete',
  message: 'Are you sure?',
);

🛠️ CLI Options #

📝 State Management Options #

Riverpod (Recommended) #

final counterProvider = StateProvider((ref) => 0);

Consumer(
  builder: (context, ref, child) {
    final count = ref.watch(counterProvider);
    return Text('Count: $count');
  },
)

Provider #

ChangeNotifierProvider(
  create: (_) => CounterModel(),
  child: MyApp(),
)

Bloc #

BlocProvider(
  create: (_) => CounterBloc(),
  child: MyApp(),
)

🤝 Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License #

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments #

• Flutter Team for the amazing framework
• Firebase for backend services
• The Dart community for excellent packages

📧 Contact #

• Ajay Chikshetty • GitHub: https://github.com/ajaychikshetty | LinkedIn: https://www.linkedin.com/in/ajaychikshetty
• Saksham Khare • GitHub: https://github.com/SakshamVK | LinkedIn: https://www.linkedin.com/in/sakshamvinodkhare/