Introduction

Overview

Building and shipping software shouldn't be complicated. .git provides a unified platform for version control, continuous integration, deployment, and monitoring — all in one place.

Whether you're a solo developer working on a side project or leading a team of hundreds, .git adapts to your needs. Start with zero configuration and scale as you grow.

Key Features

• Instant Deployments — Push code and go live in seconds with zero-config deployments
• AI-Powered CI/CD — Smart pipelines that learn from your workflow and suggest optimizations
• Global Edge Network — Deploy to 300+ edge locations worldwide for blazing-fast performance
• Enterprise Security — SOC 2 compliant with SSO, RBAC, and end-to-end encryption
• Real-time Analytics — Built-in observability with dashboards, alerts, and error tracking
• Plugin Ecosystem — 200+ integrations connecting your entire development toolchain

Quick Start

Get your first project up and running in just a few simple steps:

1. Install the .git CLI

   Install the command-line tool using your preferred package manager:

   bash Copy

   # Using npm
   npm install -g @.git/cli
   
   # Using Homebrew (macOS)
   brew install .git/cli/git
   
   # Using pip (Python)
   pip install .git-cli

2. Initialize your project

   Navigate to your project directory and initialize .git:

   bash Copy

   # Navigate to your project
   cd my-project
   
   # Initialize .git
   git init
   
   # This creates a .gitconfig file with sensible defaults
   git config init.defaultBranch main

3. Configure your deployment

   Create a configuration file for your deployment settings:

   yaml .gitconfig.yaml Copy

   name: my-project
   version: "2.0"
   
   build:
     command: "npm run build"
     output: ./dist
     env:
       NODE_VERSION: "20"
   
   deploy:
     regions:
       - us-east-1
       - eu-west-1
       - ap-southeast-1
     auto_preview: true
     rollback: auto
   
   cache:
     paths:
       - node_modules/
       - .cache/

4. Deploy to production

   Push your code and deploy with a single command:

   bash Copy

   # Deploy to production
   git deploy --prod
   
   # Output:
   ✓ Building project... (12.3s)
   ✓ Running tests... (4.1s)
   ✓ Deploying to production...
   ✓ Live at https://my-project.git.dev

Project Structure

A typical .git project follows this structure. Not all files are required — .git auto-detects your framework and configures defaults accordingly.

my-project/
├── .gitconfig.yaml      # .git configuration
├── .gitignore           # Files to exclude
├── package.json
├── src/
│   ├── components/
│   ├── pages/
│   └── utils/
├── tests/
│   ├── unit/
│   └── e2e/
├── .git/               # Git metadata (auto-created)
│   ├── config
│   ├── hooks/
│   └── objects/
└── dist/               # Build output

Configuration Reference

The .gitconfig.yaml file is the heart of your .git setup. Here are all available configuration options:

Authentication

Authenticate with .git using the CLI before running commands that require API access:

# Interactive login (opens browser)
git auth login

# Login with token (CI/CD environments)
git auth login --token $GIT_TOKEN

# Verify authentication
git auth whoami
# Output: developer@organization.git.dev

# Logout
git auth logout

Token Scopes

.git tokens support granular permission scopes:

Environment Variables

Manage environment variables through the dashboard, CLI, or directly in your config file. Variables are encrypted at rest and injected at build time.

# Set an environment variable
git env set DATABASE_URL "postgresql://user:pass@host/db"

# Set for specific environment
git env set API_KEY "sk_live_..." --env production

# List all variables
git env list

# Remove a variable
git env unset API_KEY

CLI Reference

Here are the most commonly used .git CLI commands:

# Project management
git init                        # Initialize a new project
git status                      # Check project status
git build                       # Run local build

# Deployment
git deploy                      # Deploy to staging
git deploy --prod               # Deploy to production
git deploy --preview            # Create preview deployment
git deploy --rollback           # Rollback last deployment

# Logs & monitoring
git logs                        # View deployment logs
git monitor                     # Real-time monitoring dashboard
git errors                      # View error tracking

# Team & access
git members                     # List team members
git invite user@example.com     # Invite a team member
git roles                       # Manage roles and permissions

Next Steps

Now that you understand the basics, explore these topics to deepen your knowledge:

• 📖 Quick Start Guide — Deploy your first project step by step
• ⚙️ Advanced Configuration — Deep dive into .gitconfig options
• 🔐 Security Best Practices — Keep your deployments secure
• 🤖 AI Code Review — Set up automated code reviews
• 🌍 Edge Deployments — Deploy globally for optimal performance
• 📡 REST API Reference — Programmatic access to .git