GEMINI.md: Global Rules for Google Antigravity

What is GEMINI.md?

GEMINI.md is a special Markdown file that Google Antigravity reads automatically when you start a session. It contains global rules that apply to every project you work on, regardless of which workspace you're in.

Think of it as your personal AI coding preferences - the instructions that make Antigravity feel like your perfect coding partner every time.

GEMINI.md lives in your home directory's .gemini folder:

Here's a comprehensive example you can use as a starting point:

# GEMINI.md - Global Rules for Google Antigravity

## My Coding Preferences

### Language & Framework Defaults
- Always use TypeScript over JavaScript
- Prefer functional programming patterns
- Use async/await instead of .then() chains
- Prefer named exports over default exports

### Code Style
- Use descriptive variable names (isLoading, hasError, userData)
- Keep functions under 30 lines when possible
- Add JSDoc comments for public functions
- Use early returns to reduce nesting

### Error Handling
- Always handle errors explicitly
- Use try/catch for async operations
- Log errors with context (function name, parameters)
- Never silently swallow errors

### Testing
- Write tests for business logic
- Use descriptive test names that explain the scenario
- Mock external dependencies
- Prefer integration tests over unit tests for React components

### Git & Commits
- Use conventional commit format (feat:, fix:, docs:, etc.)
- Keep commits atomic and focused
- Write clear commit messages explaining "why" not "what"

### Documentation
- Add README.md to new projects
- Document complex algorithms inline
- Keep API documentation up to date

## Things to Avoid
- No console.log in production code (use proper logging)
- No any types in TypeScript (use unknown if needed)
- No hardcoded credentials or API keys
- No inline styles in React (use CSS modules or Tailwind)