Quickstart

Get your project deployed and scalable in under 3 minutes.

⏱ ~3 min read 📅 Updated: Oct 2025 🔧 CLI v2.4.1

📋 Prerequisites

1

Install the CLI

The .git CLI is your gateway to managing projects, pipelines, and deployments. Install it globally via npm or yarn.

Terminal
npm install -g @git/cli
git --version
✓ .git CLI v2.4.1 installed successfully
💡
On macOS/Linux, you may need to prefix commands with sudo or configure your npm global path.
2

Initialize Your Project

Connect to your account and create a new project. The CLI will scaffold a production-ready structure automatically.

Terminal
git login
✓ Authenticated as @developer

git init my-app --template nextjs
✓ Project scaffolded in ./my-app
✓ Repository created at git.dev/@developer/my-app
3

Configure Deployment

Define your build commands and environment variables. .git auto-detects most frameworks, but you can override defaults.

Terminal
cd my-app
git config set build.command "npm run build"
git config set output.dir ".next"
git env add DATABASE_URL "postgresql://..."
⚠️
Never commit secrets to Git. Use git env for encrypted, scoped environment variables.
4

Deploy to Production

Push your code and let .git handle the rest. Preview URLs are generated automatically for every branch.

Terminal
git add .
git commit -m "initial commit"
git push origin main

✓ Building my-app...
✓ Running tests...
✓ Deployed to production (2.4s)
🌐 Live: https://my-app.git.dev
👀 Preview: https://main.my-app.git.dev

What's Next?