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:
- Flutter Apps: Identified by the presence of
pubspec.yamlcontainingsdk: flutter. - Angular Apps: Identified by
angular.jsonorproject.jsoncontaining@angular-devkit/build-angular. - Firebase Services: Identified by
firebase.jsonand 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_checklanguage 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:
- Open the Command Palette (
Cmd+Shift+P). - Run App Blink: Create App Blink Monorepo Workspace.
- 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)
- App Blink generates the repository structure, links local packages, and initializes Git and Firebase configs.