FlutterInit

The High-Performance Scaffolding Engine for Modern Flutter Apps

---

No installation required. Open flutterinit.com and generate.

🏛️ What is FlutterInit?

FlutterInit is a web-based scaffolding engine for Flutter.

You visit flutterinit.com, pick your architecture, state management, backend, and navigation style — and FlutterInit generates a production-ready Flutter project as a downloadable zip.

No templates to clone. No CLI to install. Open the dashboard, configure, download, build.

---

🔄 How It Works

1. Open flutterinit.com
2. Name your project and choose your options:
   • Architecture: Clean Architecture, MVVM, Feature-First
   • State Management: Riverpod, Bloc, Provider, GetX, MobX
   • Backend: Firebase, Supabase, Appwrite, or none
   • Navigation: GoRouter, AutoRoute, or imperative
   • Design: Material 3, dark mode, ScreenUtil
   • Extras: localization, logging, permissions, image picker, etc.
3. Click "Generate Project"
4. Download the .zip
5. Unzip → cd into the folder → run flutter pub get → flutter run

---

📦 What's Inside the Generated Project?

Every generated project includes:

• Folder structure matching your chosen architecture
• Routing pre-configured with your chosen navigation package
• State management boilerplate set up and ready to extend
• pubspec.yaml with all chosen dependencies declared
• Environment config (.env support via flutter_dotenv)
• Logging, error handling, and base network layer (if Dio selected)
• Material 3 theme with dark mode support
• AI context files: CLAUDE.md, AGENTS.md, .cursorrules — pre-written for your exact stack so AI editors have full project context from day one

---

⚡ Quick Start

No installation required.

1. Go to flutterinit.com
2. Configure your stack using the visual dashboard
3. Click Generate Project and download your .zip
4. Unzip and run:

cd your_project_name
flutter pub get
flutter run

That's it. Your project is ready.

---

🛠️ Prerequisites

To use a generated project

• Flutter SDK ^3.5.0 (install guide)

No other tools required. FlutterInit runs in your browser.

To run FlutterInit locally (contributors only)

• Node.js ^20.0.0 or Bun ^1.1.0
• Flutter SDK (for running dart analyze on generated output during testing)
• See CONTRIBUTING.md for full setup

---

🧩 Support Matrix

You configure all of these options directly in the dashboard — no config files, no flags. The matrix below shows every supported option.

Category	Supported Options
Architectures	Clean Architecture, MVVM, Feature-First
State Management	Riverpod, Bloc / Cubit, Provider, GetX, MobX
Functional	FPDart (Either, Option, Task), runTask Wrapper
Backend / DB	Firebase, Supabase, Appwrite, Hive, Shared Preferences
Networking	Dio (Interceptors), Http, Cached Network Image
Navigation	GoRouter, AutoRoute
Design / Motion	Flutter Animate, Skeletonizer, ScreenUtil, Native Splash
Icons	Iconsax Plus, Remix Icons, HugeIcons (Stroke/Solid)
Infrastructure	DotEnv, Logger, Easy Localization, App Version Update
Utilities	Picker (Image/File), Permissions, Share Plus, Geolocator

---

🤖 AI-Ready From Day One

Every generated project includes pre-written AI context files tailored to your exact stack:

• CLAUDE.md — for Claude Code
• AGENTS.md — for Codex and other agent workflows
• .cursor/rules/flutter-project.mdc — for Cursor

These files give your AI editor full context about your architecture, state management pattern, folder structure, and conventions — without you having to write a single prompt.

---

📚 Documentation

New to FlutterInit? Start with the Getting Started Guide.

Explore our technical guides to understand the architecture and flags:

• Getting Started Guide: From download to first successful run.
• Configuration Reference: Every project option explained in detail.
• Generated Output Reference: Understanding the "src-first" structure.
• Architecture Overview: Under the hood of the Next.js/Handlebars engine.
• Handlebars Language Guide: Logic patterns for template contributors.
• Testing Guide: Our comprehensive 2-layer validation strategy and tiered CI/CD pipeline.
• Contribution Guide: How to add your own patterns.

---

🗺️ Roadmap

We use GitHub Projects to track what's in progress and what's coming next.

👉 View the FlutterInit Roadmap

Want to contribute? Pick up any open issue labeled good first issue.

---

🧑‍💻 Running FlutterInit Locally (Contributors)

If you want to contribute to FlutterInit's engine or templates, you'll need to run it locally.

Clone & install:

git clone https://github.com/Arjun544/flutter_init.git
cd flutter_init
bun install

Start the development server:

bun run dev

Open http://localhost:3000 to use the local dashboard.

See CONTRIBUTING.md and the Architecture Overview for how the Handlebars templating engine works.

---

💻 Tech Stack

The engine powering FlutterInit:

• Frontend: Next.js 14 (App Router) + React 19
• Styling: Tailwind CSS 4 + shadcn/ui
• Templating: Handlebars.js for dynamic Dart generation
• Icons: HugeIcons & Lucide
• Runtime: Bun (High-speed package management)

---

🛠️ Built By

Arjun Mahar

Founder & Lead Architect

---

© 2026 FlutterInit Project. Released under the MIT License.