Getting Started with .git

Welcome to .git, the next-generation developer platform designed to streamline your workflow, automate deployments, and scale seamlessly with your team. This guide will help you install, configure, and start building in minutes.

💡

Prerequisites Ensure you have Node.js 18+ installed and a valid .git account. Enterprise SSO users should contact your admin before proceeding.

Installation

Install the .git CLI globally using your preferred package manager. We recommend npm for cross-platform compatibility.

                        Terminal
                        bash
                    

                        # Using npm
npm install -g @git/cli

# Using yarn
yarn global add @git/cli

# Verify installation
.git --version
                    

Project Initialization

Once installed, navigate to your project directory and run the init command. This will detect your framework, generate a .gitrc configuration file, and set up default branch rules.

                        Terminal
                        bash
                    

                        .git init

# Output:
✔ Detected Next.js 14 project
✔ Generated .gitrc
✔ Configured default branch rules
✔ Linked to workspace: acme-app
# Ready to deploy!
                    

Configuration

The .gitrc file controls deployment targets, environment variables, and pipeline triggers. You can edit it manually or use the interactive config wizard.

Property	Type	Description
`build.command`	String	Shell command to build your application
`output.dir`	String	Path to the built output directory
`regions`	Array	Target edge regions for deployment
`autoPreview`	Boolean	Enable automatic preview URLs for PRs

⚠️

Security Note Never commit sensitive environment variables directly. Use .git config:set to encrypt secrets at rest.

Authentication

Before deploying, authenticate your CLI session. This links your local environment to your .git account and workspace.

                        Terminal
                        bash
                    

                        .git auth login

# Opens browser for OAuth flow
✔ Authenticated as dev@acme.dev
✔ Selected workspace: production
                    

Next Steps

Read the Deployment Guide to understand production workflows
Explore Environment Variables for secure config management
Check out Team Collaboration features for shared workspaces