APPIQ SOLUTION: Flutter Mobile Development Extension for BMAD Method
npm install appiq-solution


A specialized extension of the BMAD Method for Flutter Mobile App Development
APPIQ SOLUTION extends the proven BMAD Method with first-class Flutter support featuring Clean Architecture, Cubit patterns, BLoC state management, dependency injection, and modern Mobile Development Best Practices.
Simple and fast:
``bash`
npx appiq-solution
The Smart Installer configures:
β
Multi-IDE Support: Cursor, Claude Code, Windsurf, VS Code + Cline, and more
β
Auto-detect Tech Stack: Flutter, React, Vue, Next.js, Angular, Fullstack, API-only
β
Smart MCP Integration: Agents know which MCP servers they can use (no auto-config)
β
Planning Workflow: Project idea β Plan generation β Approval β Development
β
Full BMAD Flow: Document sharding, Agent orchestration, Development cycle
β
π― Advanced Flutter Support: Dart MCP Server integration, Clean Architecture, Cubit patterns, BLoC state management, dependency injection with GetIt, proper testing strategies
β
Modern Web: shadcn/ui, v0.dev, Tailwind CSS integration
β
Security First: No API Keys stored or auto-configured
APPIQ SOLUTION is built on the BMAD Method - a proven AI-driven development framework that uses specialized AI agents to handle the complete software development lifecycle.
BMAD Method's Two Key Innovations:
1. Agentic Planning: Dedicated agents (Analyst, PM, Architect) collaborate with you to create detailed, consistent PRDs and Architecture documents. Through advanced prompt engineering and human-in-the-loop refinement, these planning agents produce comprehensive specifications that go far beyond generic AI task generation.
2. Context-Engineered Development: The Scrum Master agent then transforms these detailed plans into hyper-detailed development stories that contain everything the Dev agent needs - full context, implementation details, and architectural guidance embedded directly in story files.
This two-phase approach eliminates both planning inconsistency and context loss - the biggest problems in AI-assisted development.
Your agents know these MCP servers (you configure them manually in your IDE):
π§ Sequential Thinking: Complex problem solving
π Puppeteer: Browser automation and testing
π Claude Continuity: Enhanced thread continuity
πΎ Extended Memory: Enhanced AI memory capabilities
β¨ 21st.dev Magic: UI builder like v0 in your IDE
π± Dart MCP: Flutter/Dart development (auto-detected for Flutter projects)
π₯ Firebase: Auth, Firestore, Functions integration
β‘ Supabase: Database, auth, storage
π Context7: Up-to-date library documentation
π³ Stripe: Payment integration
ποΈ Clean Architecture: Domain-driven Design, clean layer separation
π State Management: Cubit patterns, BLoC integration
π οΈ Best Practices: GetIt dependency injection, null safety
π¨ Material 3: Modern UI components, theming
π§ͺ Testing: Unit, Widget, and Integration tests
π¦ Package Management: Curated package recommendations
`bash`
npx appiq-solution
Important selections during installation:
- Choose the appiq-flutter-mobile-dev Expansion Pack.bmad-core/
- Provide the path to your existing Architecture MD file
- The system will install Flutter agents in
Since you already have documented architecture, this is the perfect starting point:
`bash`
@architect
What happens here:
- The Architect agent reads your architecture document
- Analyzes your existing code
- Creates a "Brownfield Analysis" with recommendations
- Defines how new features fit into your existing structure
Now use the Master Flutter Orchestrator to automatically handle everything:
`
/flutter-init-agent - Erstelle eine TikTok-Γ€hnliche Livestream-UI mit:
- Vertical Video Player (Vollbild)
- Like Button mit Animation
- Share Button
- Kommentar-System (Real-time)
- Viewer Counter
- Follow Button
Target Folder: lib/features/livestream/
Screenshots: [Optional: FΓΌge Screenshots oder Mockups hinzu]
`
The flutter-init-agent will automatically orchestrate the complete development process:
#### π― Phase 1: Automatic Analysis
- Scans your existing codebase using npx appiq-solution flatten
- Analyzes architecture patterns (routing, state management, DI)
- Identifies integration points with your existing features
- Plans implementation strategy for the new feature
#### ποΈ Phase 2: Team Orchestration
The agent automatically triggers this sequence:
2.1 Product Owner (@po)
- Creates user stories, epics, and acceptance criteria
- Defines feature breakdown and requirements
2.2 Architect (@architect)
- Analyzes existing codebase structure
- Plans integration with current architecture
- Defines backend requirements (Supabase tables, etc.)
- Creates implementation guidelines
2.3 UI Development (@flutter-ui-agent)
- Creates pages and navigation integration
- Implements custom widgets and animations
- Ensures responsive design and accessibility
2.4 State Management (@flutter-cubit-agent)
- Implements Cubit/BLoC patterns matching your existing setup
- Handles error states and loading management
- Integrates with current state management
2.5 Business Logic (@flutter-domain-agent)
- Creates entities, use cases, and business rules
- Implements validation and business logic
- Defines repository interfaces
2.6 Data Layer (@flutter-data-agent)
- Implements repository pattern
- Creates API integration and caching
- Handles data serialization and persistence
2.7 Backend Integration (MCP Supabase/Firebase)
- Creates database tables and relationships
- Sets up authentication and security rules
- Implements real-time features
2.8 Quality Assurance (@qa)
- Performs code review against existing patterns
- Implements comprehensive testing strategy
- Validates architecture consistency
2.9 Security Audit (@flutter-security-agent)
- Checks for security vulnerabilities
- Validates API key protection
- Ensures data privacy compliance
2.10 Git Integration
- Commits changes with proper messages
- Creates feature branches
- Prepares for code review
Since you also need backend functions:
`bash`
@backend-dev
After each phase runs automatically:
- Code review against your existing patterns
- Consistency check with documented architecture
- Testing (Unit, Widget, Integration tests)
- Security validation
bash
npx appiq-solution # Choose appiq-flutter-mobile-dev
@architect # Analyze existing architecture (optional)
`$3
`
/flutter-init-agent - Erstelle ein Instagram-Γ€hnliches Story Feature mit:
- Vollbild Story Viewer
- Progress Indicators
- Swipe Navigation
- Story Creation (Foto/Video)
- Story Archive
- View AnalyticsTarget Folder: lib/features/stories/
Backend: Supabase (stories table, media storage)
Integration: Mit bestehendem User System
`$3
β
Complete codebase analysis and architecture understanding
β
Automatic team orchestration through all specialized agents
β
End-to-end implementation from UI to backend
β
Quality assurance and security validation
β
Git integration with proper commits You only need to:
- Provide the initial feature description
- Give feedback when agents ask for clarification
- Review and approve the final implementation
$3
- /flutter-init-agent - Master orchestrator for complete features
- /flutter-ui-agent - UI components and design
- /flutter-cubit-agent - State management
- /flutter-domain-agent - Business logic
- /flutter-data-agent - Data layer and APIs
- /flutter-security-agent - Security auditingποΈ Codebase Context Management
Automatic context export after every feature/milestone:
`bash
Manual execution
npx bmad-method flattenWith custom output (for AI agents)
npx bmad-method flatten --output context/current-codebase.xmlAutomatically in package.json scripts:
{
"scripts": {
"flatten": "npx bmad-method flatten --output context/milestone-$(date +%Y%m%d).xml",
"posttest": "npm run flatten",
"postbuild": "npm run flatten"
}
}
`Where it's saved:
- Standard:
flattened-codebase.xml in current directory
- Custom: Any path with --output parameter
- Recommendation: context/` folder for better organizationBenefits for Flutter development:
β
AI agents always have current codebase context
β
Perfect for code reviews and architecture discussions
β
Easy knowledge transfer between team members
π User Guide - Complete guide to Flutter development with AI agents
π± Flutter Expansion Pack - Specialized Flutter agents and templates
ποΈ BMAD Core Architecture - Technical deep dive into the framework
π¬ Discord Community
π Issue Tracker
π¬ Discussions
π Support the Project via PayPal
MIT Β© Viktor Hermann