Skip to content
Docs
Main site, archipelago.banuacoder.com

Getting Started

Introduction ​

What is Archipelago? ​

Archipelago is a Flutter boilerplate generator and CLI toolkit that helps you ship production-ready Flutter apps in days, not weeks.

The name is inspired by the Indonesian archipelago — each feature module is a self-contained island, connected by shared infrastructure (the water between islands).

What You Get ​

CLI Toolkit ​

A Dart CLI that scaffolds your entire Flutter monorepo with enterprise-grade architecture baked in:

  • Project generation — Full monorepo with apps, packages, and features pre-wired
  • Feature generation — Add new feature modules with a single command
  • Doctor command — Verify your environment is ready
  • Authentication — Tier-based access (Free, Pro, Enterprise)

76 Mason Bricks ​

Pre-built, production-ready code templates covering:

  • Full monorepo scaffold
  • Individual feature modules with state management choice (bloc/cubit/riverpod/provider)
  • Shared packages (networking, storage, auth, monitoring)
  • CI/CD configurations (GitHub Actions, GitLab CI)
  • Fastlane setup for iOS and Android

Monorepo Toolkit ​

Generated directly into your project (no CLI dependency at runtime):

  • Affected detection — Only build/test what changed
  • Dependency graph — Visualize package relationships
  • Coverage aggregation — Unified coverage reports
  • Build preparation — Debug/release dependency swapping

Debug Tools and Blackbox ​

  • In-app debugger (Pro) — A full-screen debugger with network, analytics, storage and more inspector tools. Internal flavors keep it, also in release mode; the production flavor strips it. See app_debugger
  • Blackbox — A session recorder for internal builds (development, staging, alpha, beta): metrics, frame times, filesystem changes, events, markers and screen recording in one .bbx file, opened in the Blackbox viewer. Recording and cloud sync are Enterprise

Web Tools ​

AI Agent Files ​

Every generated project ships instructions for AI coding agents: CLAUDE.md, AGENTS.md, .cursorrules and Copilot instructions. See AI Agent Support.

Architecture Patterns ​

Battle-tested patterns from years of building fintech apps with 20+ million daily active users:

  • API/Impl split — Clean boundaries between contract and implementation
  • Dual-GetIt DI — Global singletons + per-feature scoped injection
  • FeatureSDK self-registration — Features register themselves, no manual wiring
  • Two-phase initialization — Blocking pre-launch + non-blocking post-launch

Next Steps ​

Ready to dive in? Head to the Getting Started guide.