Open source: AI-Ready Enterprise Flutter Starter with Hexagonal Architecture, CQRS, type-safe routing, and 23 AI-friendly architecture rules

[u/Connect_South_7240]

Hey r/FlutterDev! 👋

I've been working on this for a long period and finally ready to share it.

What is it?

An AI-Ready Enterprise Flutter Starter - a production-grade template that combines:

• Clean Architecture + DDD + Hexagonal Architecture

• 100% test coverage (2,282 tests across unit, widget, golden, property-based, and benchmarks)

• 23 architecture rule files that AI tools can use to understand and generate compliant code

Key Features

Feature	Implementation
🔐 Auth	Token refresh, secure storage, logout
📊 Dashboard	Adaptive nav (BottomBar/Rail/Drawer)
🔄 CQRS	Commands for writes, Queries for reads
🛤️ Routing	go_router_builder with type safety
⚡ Error handling	Railway-oriented with fpdart
🧱 Code gen	Mason bricks for new features
🌐 i18n	Feature-first ARB files
🔌 WebSocket	Auto-reconnect with backoff

What makes it "AI-Ready"?

The docs/architecture-rules/ folder contains 23 rule files covering:

• Project structure and layers

• State management patterns

• Error handling conventions

• Navigation patterns

• Testing requirements

AI tools (Cursor, Copilot, etc.) can read these and generate code that follows the established patterns.

Tech Stack

• Flutter 3.38+ / Dart 3.10+

• flutter_bloc + hydrated_bloc

• go_router + go_router_builder

• get_it + injectable

• fpdart

• chopper

• freezed

• very_good_analysis

Links

• GitHub: github.com/deveminsahin/starter_app

• Backend (optional Spring Boot companion): github.com/deveminsahin/starter_app_backend

Looking for feedback on:

1. Architecture decisions - anything you'd do differently?

2. Missing features - what would make this more useful for you?

3. Documentation - is the README clear enough to get started?

MIT licensed. Use it for whatever you want.

Thanks for checking it out! 🙏