Verify Local Tools
git --version
node --version
npm --version
Install Git from the official Git distribution or the approved package manager if the first command is not recognized.
Configure Git Identity
git config --global user.name "Cloudberrie Engineering"
git config --global user.email "accounts@cloudberrie.com"
git config --global init.defaultBranch main
For individual team members, use their approved work identity rather than the shared administrative identity.
Initial Push for Existing Local Files
cd /path/to/project
git init
git status
git add .
git commit -m "chore: initialize Cloudberrie project"
git branch -M main
git remote add origin https://github.com/cloudberrie-studio/cb-website.git
git push -u origin main
Authentication
Use GitHub’s supported browser authentication, Git Credential Manager, or SSH. GitHub account passwords are not used as Git HTTPS passwords. Do not paste personal access tokens into scripts or documentation.
Clone an Existing Repository
git clone https://github.com/cloudberrie-studio/cb-website.git
cd cb-website
git status
Before the First Push
- Inspect
git status. - Confirm
.env, service-account JSON, private keys, exports containing personal data, and dependency folders are excluded. - Search the staged diff for secrets.
- Confirm the remote points to the organization repository, not a personal repository.
If a secret was committed: removing it in a later commit is not sufficient. Revoke/rotate the secret immediately and follow the history-cleanup runbook.