App Blink is built from the ground up for modern developer monorepos, allowing Flutter mobile apps, Angular web portals, shared UI component packages, and Firebase serverless backends to coexist in a single Git repository.


πŸ—οΈ Supported Workspace Topologies

1. Unified Polyglot Monorepo (Recommended)

Combines Dart/Flutter and TypeScript/Angular with shared assets and backends:
my-monorepo/
β”œβ”€β”€ angular/
β”‚   β”œβ”€β”€ apps/
β”‚   β”‚   β”œβ”€β”€ web-portal/         # Customer Angular web app
β”‚   β”‚   └── admin-dashboard/    # Operations dashboard
β”‚   └── packages/
β”‚       β”œβ”€β”€ components/         # Shared Spartan / Tailwind components
β”‚       └── services/           # Shared API client services
β”œβ”€β”€ flutter/
β”‚   β”œβ”€β”€ apps/
β”‚   β”‚   └── mobile_app/         # iOS & Android Flutter app
β”‚   └── packages/
β”‚       └── workern_widgets/    # Shared Flutter widgets & theme
β”œβ”€β”€ tools/
β”‚   └── firebase/
β”‚       β”œβ”€β”€ functions-ts/       # Cloud Functions v2 (TypeScript)
β”‚       β”œβ”€β”€ firestore.rules     # Database security rules
β”‚       └── firestore.indexes.json
β”œβ”€β”€ .appblink/
β”‚   β”œβ”€β”€ codeindex.md            # AI discovery index of shared components
β”‚   └── workspace.json          # App Blink workspace manifest
└── package.json

2. Standalone Single-App Workspace

If you are developing an isolated Flutter app or standalone Angular project without a monorepo, App Blink adapts automatically, scoping tasks, VibeChecks, and publishing controls to that single project.

πŸ”„ Automatic App Discovery

Upon workspace launch, App Blink's workspaceDetector.ts performs directory scans:

  1. Flutter Apps: Identified by the presence of pubspec.yaml containing sdk: flutter.
  2. Angular Apps: Identified by angular.json or project.json containing @angular-devkit/build-angular.
  3. Firebase Services: Identified by firebase.json and directory paths containing Firestore rules or Cloud Functions.

All detected apps are immediately listed in the Applications tree view in the sidebar.


⚑ The Code Index (`.appblink/codeindex.md`)

To prevent duplicate code and ensure AI agents reuse existing components, App Blink automatically generates and updates .appblink/codeindex.md.

  • What it indexes: All exported Angular standalone components, directives, pipes, services, and Flutter widgets across shared packages (angular/packages/*, flutter/packages/*).
  • How AI agents use it: The #appblink_component_reuse_check language model tool queries this index before generating new UI code.
  • Manual Rebuild: Run App Blink: Rebuild Monorepo Code Index (appblink.codeindex.rebuild) at any time to refresh the catalog.

πŸš€ Creating a New Monorepo (`appblink.createMonorepo`)

To bootstrap a production-ready monorepo with cross-platform sharing:

  1. Open the Command Palette (Cmd+Shift+P).
  2. Run App Blink: Create App Blink Monorepo Workspace.
  3. Select your desired scaffolding options:
    • Target platforms (Flutter iOS/Android, Angular Web, Cloud Functions)
    • UI design system (Spartan UI, Tailwind CSS, Material Design)
    • Package manager preference (pnpm, npm)
  4. App Blink generates the repository structure, links local packages, and initializes Git and Firebase configs.