.antigravity File Complete Reference

1. Style Rules

Define code formatting and style preferences:

## Style
- Use 2 spaces for indentation
- Always use semicolons
- Prefer single quotes for strings
- Use trailing commas in multiline arrays/objects

2. Technology Rules

Specify frameworks, libraries, and versions:

## Technology Stack
- Framework: Next.js 15 with App Router
- Styling: Tailwind CSS (no CSS modules)
- State: React Query for server state, Zustand for client
- Database: Supabase with Drizzle ORM
- Testing: Vitest + React Testing Library

3. Architecture Rules

Define project structure and patterns:

## Architecture
- Use feature-based folder structure
- Shared components in /src/components/ui
- Feature components in /src/features/[feature]/components
- All API calls through /src/lib/api
- No direct fetch() calls in components

4. Workflow Rules

Guide the agent's behavior and process:

## Workflow
- Always create a plan before implementing
- Run tests after making changes
- Update documentation when adding features
- Ask for clarification if requirements are unclear

Next.js Project

# Next.js 15 Project Rules

## Framework
- Next.js 15 with App Router
- TypeScript strict mode enabled
- Server Components by default
- Use 'use client' only when necessary

## Styling
- Tailwind CSS for all styling
- Use CSS variables for theming
- Mobile-first responsive design
- Use cn() helper for conditional classes

## Components
- Functional components only
- Props interface above component
- Export default for page components
- Named exports for shared components

## Data Fetching
- Server Components for initial data
- React Query for client-side fetching
- Implement proper loading states
- Handle errors gracefully

## File Structure
src/
├── app/           # Next.js App Router
├── components/    # Shared components
│   └── ui/       # Base UI components
├── lib/          # Utilities and helpers
├── hooks/        # Custom React hooks
└── types/        # TypeScript types

Python FastAPI Project

# FastAPI Project Rules

## Framework
- FastAPI with Pydantic v2
- Python 3.11+
- Async/await for all I/O operations
- SQLAlchemy 2.0 with async sessions

## Code Style
- Type hints for all functions
- Docstrings for public functions
- Black formatting (line length 88)
- isort for import sorting

## API Design
- RESTful conventions
- Versioned endpoints (/api/v1/)
- Consistent error responses
- OpenAPI documentation

## Architecture
app/
├── api/          # Route handlers
├── core/         # Config and security
├── models/       # SQLAlchemy models
├── schemas/      # Pydantic schemas
├── services/     # Business logic
└── utils/        # Helpers

Exclude Patterns

Prevent the AI from reading or modifying certain files:

## Exclude Patterns
exclude_patterns:
  - node_modules/**
  - .git/**
  - dist/**
  - coverage/**
  - *.log
  - .env*
  - secrets/**

This improves performance and prevents accidental exposure of sensitive data.

MCP Server Integration

Configure MCP servers in your .antigravity file:

## MCP Servers
Use the following MCP servers:
- @supabase/mcp for database operations
- @github/mcp for repository management
- @stripe/mcp for payment integration

Configure in .antigravity/mcp.json

Browse available MCP servers in our MCP directory.

Agent Mode Configuration

Configure Agent Mode behavior:

## Agent Mode Settings
When using Agent Mode:
- Always create a plan before implementation
- Ask for confirmation before destructive operations
- Run tests after making changes
- Provide progress updates during long tasks
- Stop and ask if encountering unexpected errors