Quickstart
Get your project deployed and scalable in under 3 minutes.
📋 Prerequisites
- Node.js 18+ or Python 3.10+
- Git installed & configured
- Free .git account
- Basic terminal familiarity
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