App Blink unifies Angular web apps and Flutter mobile apps into one integrated developer experience. Scaffold production-ready monorepos, emulate Firebase locally with zero cloud bills, run side-by-side simulators, and automate store publishing directly from your sidebar.
Before You Begin
Ensure your development environment meets the following baseline prerequisites:
- IDE: AntiGravity or Visual Studio Code (version 1.85 or higher) with the App Blink extension installed.
- Mobile SDKs: Android Studio with at least one configured Android Virtual Device (AVD), and Xcode (on macOS) with iOS Simulator runtimes installed.
- Runtimes: Node.js 18+ and Java 17+ (required for the local Firebase emulator suite).
- AI Credentials (Optional): Google Gemini API key configured in your environment for AI logo generation, vibe checks, and automated code review.
Physical mobile devices connected via Wi-Fi or USB automatically resolve local development services without manual network proxy configuration.
Step 1: Verify Dev Toolchains with App Blink Doctor
Before running projects, verify that your native SDKs, simulators, and CLI tools are properly installed and discoverable by the IDE.
- Open the Command Palette using
Cmd+Shift+P(macOS) orCtrl+Shift+P(Windows/Linux). - Type and run:
App Blink: Doctor
The Doctor diagnostics hub inspects your toolchain and verifies:
- Android Studio SDK path and active AVD emulators
- Xcode CLI tools, CocoaPods, and iOS Simulator runtimes
- Flutter SDK version and Dart runtime
- Node.js, npm/pnpm, and Firebase CLI installations
- Gemini API authentication status
If any item shows a warning or error, click the Auto-Fix button next to the diagnostic item in the sidebar to resolve common path issues automatically.
Step 2: Initialize a Unified Monorepo Workspace
App Blink organizes cross-platform projects into a clean, shared monorepo structure where Angular web apps, Flutter mobile apps, and Firebase backends coexist seamlessly.
- Open the Command Palette (
Cmd+Shift+P/Ctrl+Shift+P). - Select App Blink: Create Workspace.
- Choose your workspace directory.
App Blink scaffolds the standard workspace layout:
my-workspace/
├── angular/apps/ # Modern Angular web applications (Tailwind CSS & Spartan UI)
├── flutter/apps/ # Flutter mobile applications for iOS & Android
├── tools/firebase/ # Local Firestore rules, Auth config, and Cloud Functions
├── assets/ # Application icons, framed screenshots, and brand tokens
└── .agents/ # Workspace rules, coding guardrails, and AntiGravity skills
Step 3: Scaffold Your Dual-Platform Application
Create an Angular web app and a matching Flutter mobile app pair with shared domain conventions.
- Click the App Blink icon on the primary Activity Bar to open the Applications view.
- Click Create New App (or execute
appblink.createApp). - Enter your application name (e.g.,
Expired Products Finder). - Select both Web (Angular) and Mobile (Flutter) in the platform checklist.
- Choose your initial design aesthetic. Gemini AI generates matching Material 3 and Tailwind color tokens for both codebases.
App Blink automatically generates standard platform identifiers:
- Web folder:
angular/apps/expired-products-finder - Mobile folder:
flutter/apps/expired_products_finder - Shared Class Prefix:
ExpiredProductsFinder
Step 4: Start Local Firebase Emulators
App Blink eliminates cloud costs during development by running the complete Firebase suite on your local machine.
- In the App Blink sidebar, expand the Services panel.
- Click Start Emulators to boot the local suite:
- Cloud Firestore:
http://localhost:8081 - Firebase Authentication:
http://localhost:9100 - Cloud Functions:
http://localhost:5001 - Emulator UI Dashboard:
http://localhost:4000
- Cloud Firestore:
When launching applications, App Blink prompts: "Run with Firebase Emulators?". Selecting Yes automatically points your Angular and Flutter environments to localhost without touching production config.
Step 5: Run Web and Mobile Simulators Side-by-Side
Launch both targets simultaneously to test cross-platform parity in real time.
Launching Angular Web
- In the Applications view, expand your web app (
expired-products-finder). - Click the Run button (or run
nx serve expired-products-finder). - Your web app opens immediately at
http://localhost:4200with hot-module reloading enabled.
Launching Flutter Mobile
- Click the device picker in the status bar (or run
App Blink: Pick Device). - Select your target device:
- Android: Google Pixel 5 or Pixel 7 AVD
- iOS: Apple iPhone 15 or iPhone 16 Simulator
- Chrome: Flutter Web preview
- Click Run to compile, boot the simulator, and link to the local Firebase emulators.
Step 6: Enforce AI Code Quality and Vibe Checks
App Blink integrates coding guardrails to ensure code generated by AI models adheres to your repository's architectural patterns.
- Vibe Checks Guardrail: Use
#appblink_vibecheck_guardrailin your prompt to enforce strict DRY principles, test coverage targets, and Spartan UI component usage. - Component Reuse Check: Use
#appblink_component_reuse_checkto prevent duplicate UI widgets and leverage existing shared packages. - Auto-Localization on Save: Edit ARB or JSON translation files; App Blink automatically translates new translation keys into 80+ world languages upon saving.
- Save-Triggered Testing: Automatically synthesize unit tests and Jasmine specs whenever core business logic files are modified.
Step 7: Configure Native Permissions and Secrets
Mobile hardware access (such as barcode cameras, location, or push notifications) requires strict native permission declarations.
- If your app accesses device hardware (e.g., scanning barcodes with the camera), execute:
App Blink: Fix iOS Permissions - App Blink audits your Flutter Dart code and automatically injects store-compliant permission strings into
ios/Runner/Info.plistandandroid/app/src/main/AndroidManifest.xml. - Store encrypted production credentials and API keys using the built-in Automation Vault (
appblink.updateVaultKey).
Step 8: Production Builds and Store Publishing
When you are ready to ship, App Blink automates bundle packaging, signing, and track deployments.
Web Deployment
# Build and publish Angular web bundle to hosting
appblink publish:web --app=expired-products-finder
Store Release (Google Play & App Store)
- Google Play: Builds signed
.aabAndroid App Bundles and pushes to internal testing tracks via Fastlane. - Apple App Store: Generates signed iOS archives, uploads
.ipabuilds to TestFlight, and synchronizes App Store metadata in one click.
Next Steps
Now that your workspace is configured and running:
- Explore Doctor Diagnostics for deep toolchain audits.
- Read the Unified Monorepo Setup guide to organize shared packages.
- Learn how to configure Firebase Emulators and test serverless Cloud Functions locally.