Welcome to .git Documentation

Master the next-generation developer platform. This guide covers everything from initial setup to advanced CI/CD pipelines, API integration, and team workflows.

ℹ️ New to .git?

Start with the Quick Start guide to deploy your first project in under 5 minutes.

On this page

Installation

.git can be installed via package managers or directly from our binary releases. We support macOS, Linux, and Windows (via WSL).

bash

# macOS (Homebrew)
brew install --cask git-dev

# Linux (curl)
curl -fsSL https://git.dev/install.sh | sh

# npm (Node.js projects)
npm install -g @git/cli

⚠️ System Requirements

Requires Node.js 18+, Python 3.9+, or Go 1.20+. Ensure your PATH includes your package manager's binary directory.

Quick Start

Follow these steps to initialize and deploy your first project:

Initialize a new project directory
Connect your repository
Deploy to production

terminal

$ git init my-app
$ cd my-app
$ git link github.com/username/my-app
$ git deploy --env production

✓ Build completed in 1.2s
✓ Deployed to https://my-app.git.dev
✓ SSL certificate provisioned

🚀 Next Steps

Configure your .gitconfig file to set up branch rules, preview deployments, and team access controls.

Configuration

Project settings are managed via .gitconfig at your repository root. The file supports YAML and JSON formats.

.gitconfig

project:
  name: my-app
  framework: nextjs
  build:
    command: "npm run build"
    output: ".next"

deploy:
  preview:
    branches: ["feature/*", "develop"]
    auto: true
  production:
    branch: "main"
    auto: true
    review: false

hooks:
  pre-commit: "npm test"
  post-deploy: "curl https://webhook.site/renew-ssl"

Field	Type	Description	Default
`project.framework`	string	Auto-detects build commands	auto
`deploy.preview.auto`	boolean	Enable automatic preview URLs	true
`hooks.pre-commit`	string	Command run before commit	none

CLI Reference

The git CLI provides commands for project management, deployment, and environment configuration.

git init

Initializes a new .git project or migrates an existing repository.

Usage

git init [project-name] [options]

Options:
  --framework <type>  Specify framework (nextjs, react, go, python)
  --region <code>     Deploy region (us-east, eu-west, ap-south)
  --template <url>    Use a custom project template

git deploy

Builds and deploys the current project to the specified environment.

Usage

git deploy [environment] [options]

Environments: dev, staging, production
Options:
  --dry-run     Validate build without deploying
  --force       Skip confirmation prompts
  --region <id> Override default deployment region

💡 Pro Tip

Use git deploy --preview to instantly generate a temporary URL for pull request testing.

API Reference

Interact with .git programmatically using our RESTful API. All requests require Bearer token authentication.

bash

curl -X POST https://api.git.dev/v2/deployments \
  -H "Authorization: Bearer $GIT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repo_id": "github:user/my-app",
    "branch": "main",
    "env": "production",
    "options": { "auto_ssl": true, "region": "us-east-1" }
  }'

Base URL: https://api.git.dev/v2/
Authentication: API keys available in your Dashboard > Settings > API Keys

Frequently Asked Questions

How do I migrate from another platform?

Run git migrate --from vercel/netlify to automatically sync your projects, domains, and environment variables. Full migration guide here.

Is there a free tier?

Yes. The Starter plan supports 3 projects, 100GB bandwidth, and automatic HTTPS. No credit card required.

Can I use self-hosted runners?

Absolutely. Configure runner: self-hosted in your .gitconfig and deploy your own agents using our Docker image.

Community & Support

Join thousands of developers building with .git.

Discord Community — Real-time help & discussions
GitHub Discussions — Feature requests & RFCs
Status Page — System uptime & incident logs
Email Support — For Pro & Enterprise plans