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.
NOTE

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.

  1. Open the Command Palette using Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux).
  2. 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
TIP

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.

  1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P).
  2. Select App Blink: Create Workspace.
  3. 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.

  1. Click the App Blink icon on the primary Activity Bar to open the Applications view.
  2. Click Create New App (or execute appblink.createApp).
  3. Enter your application name (e.g., Expired Products Finder).
  4. Select both Web (Angular) and Mobile (Flutter) in the platform checklist.
  5. 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.

  1. In the App Blink sidebar, expand the Services panel.
  2. 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
NOTE

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

  1. In the Applications view, expand your web app (expired-products-finder).
  2. Click the Run button (or run nx serve expired-products-finder).
  3. Your web app opens immediately at http://localhost:4200 with hot-module reloading enabled.

Launching Flutter Mobile

  1. Click the device picker in the status bar (or run App Blink: Pick Device).
  2. Select your target device:
    • Android: Google Pixel 5 or Pixel 7 AVD
    • iOS: Apple iPhone 15 or iPhone 16 Simulator
    • Chrome: Flutter Web preview
  3. 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_guardrail in your prompt to enforce strict DRY principles, test coverage targets, and Spartan UI component usage.
  • Component Reuse Check: Use #appblink_component_reuse_check to 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.

  1. If your app accesses device hardware (e.g., scanning barcodes with the camera), execute:
    App Blink: Fix iOS Permissions
    
  2. App Blink audits your Flutter Dart code and automatically injects store-compliant permission strings into ios/Runner/Info.plist and android/app/src/main/AndroidManifest.xml.
  3. 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 .aab Android App Bundles and pushes to internal testing tracks via Fastlane.
  • Apple App Store: Generates signed iOS archives, uploads .ipa builds to TestFlight, and synchronizes App Store metadata in one click.

Next Steps

Now that your workspace is configured and running: