Antigravity Manager Developer Guide

🏗️ Architecture Overview

Antigravity Manager is a hybrid Desktop Application built with Electron, React, and NestJS. It follows a modular architecture where the frontend (Renderer) communicates with the backend (Main) via type-safe IPC (ORPC).

graph TD
    User[User Interface] -->|React/Vite| Renderer[Renderer Process]
    Renderer -->|ORPC Client| IPC[IPC Layer]
    IPC -->|ORPC Router| Main[Main Process]
    Main -->|Bootstraps| Server[NestJS Server]
    Main -->|Calls| Services[Service Layer]
    Services -->|Read/Write| DB[(SQLite Database)]
    Services -->|HTTP| Cloud[Cloud APIs (Google/Anthropic)]

Key Technologies

• •Frontend: React 19, TailwindCSS v4, TanStack Router, TanStack Query.
• •Backend: Electron (Main), NestJS (Core Logic), Better-SQLite3 (Data).
• •Communication: ORPC (Type-safe IPC wrapper around Electron IPC).
• •Build: Electron Forge + Vite.

📂 Directory Structure

• •src/main.ts: Electron Main Process entry point.
• •src/preload.ts: Bridge between Main and Renderer.
• •src/renderer.tsx: React App entry point.
• •src/components/: Reusable React UI components (Radix UI based).
• •src/ipc/: IPC Routers and Handlers (Domain logic).
  • •router.ts: Main ORPC router definition.
  • •account/, cloud/, database/: Domain-specific handlers.
• •src/server/: NestJS application modules (proxies/gateways).
• •src/services/: Core business logic (framework agnostic).
  • •GoogleAPIService.ts: Gemini/Cloud interactions.
  • •AutoSwitchService.ts: Account rotation logic.
• •src/routes/: Frontend routing definitions (File-based).

🚀 Development Workflow

Prerequisites

• •Node.js 18+
• •npm (Project uses package-lock.json)

Common Commands

• •Start Dev Server: npm start
• •Lint Code: npm run lint
• •Unit Test: npm run test:unit
• •E2E Test: npm run test:e2e
• •Build Production: npm run make

🧠 Core Concepts

IPC Communication (ORPC)

The project uses orpc for type-safe communication.

• •Define: Create a router in src/ipc/router.ts with Zod schemas.
• •Implement: Add logic in handlers (e.g., src/ipc/account/handler.ts).
• •Call: Use the generated client in React components.

Database Access

Data is stored in a local SQLite file (test.db in dev, user data in prod).

• •Use Better-SQLite3 for direct access.
• •Logic should be encapsulated in src/services or src/ipc.

Account Management

• •Accounts are added via OAuth (Google/Claude).
• •GoogleAPIService handles token exchange and refreshing.
• •AutoSwitchService monitors usage and switches active accounts automatically.

⚠️ Critical Rules

1. •Type Safety: strict TypeScript usage; Zod for runtime validation.
2. •Components: Use src/components/ui (Radix primitives) for consistency.
3. •Async: Handle all IPC/DB calls asynchronously with try/catch.
4. •Security: Never commit secrets. API keys are user-provided or encrypted locally.