Repositories
A repository holds the files, branches, and history for one project. This guide walks through creating a repository and connecting to it from your computer.
Create a Repository
Section titled “Create a Repository”- Open Git from your workspace.
- Select the + menu in the top-right corner, then New Repository.
- Enter a name, and optionally a short description.
- Choose the visibility. New repositories are Private by default — only members you grant access can see them.
- Optionally select Initialize Repository to add a README, a
.gitignore, and a license. - Select Create Repository.
Generate a Personal Access Token
Section titled “Generate a Personal Access Token”Because you sign in through PlaidCloud, your account has no separate Git password. To clone or push over HTTPS from the command line, create a personal access token and use it in place of a password.
- Select your avatar in the top-right corner, then Settings.
- Open the Applications tab.
- Under Manage Access Tokens, enter a name that describes where you’ll use the token (for example,
laptop). - Select the repository read and write scopes so the token can clone and push.
- Select Generate Token.
- Copy the token and store it somewhere safe. You won’t be able to view it again.
Clone a Repository
Section titled “Clone a Repository”-
Open the repository in PlaidCloud Git.
-
Select Code, then copy the HTTPS clone URL.
-
In a terminal, run
git clonewith that URL:Terminal window git clone https://git.example.plaidcloud.com/you/my-repo.git -
When Git prompts for credentials, enter your PlaidCloud username and paste the access token as the password.
Commit and Push Changes
Section titled “Commit and Push Changes”From inside a cloned repository:
- Stage your changes:
git add . - Record them with a message:
git commit -m "Describe what changed" - Send them to PlaidCloud Git:
git push
Your commits appear in the repository’s Commits and Activity views, and on any branch or pull request that includes them.
Manage Access and Visibility
Section titled “Manage Access and Visibility”Open a repository’s Settings tab to rename it, change its visibility, or transfer ownership. To let other members contribute, use Settings → Collaborators and add them by username with a Read, Write, or Administrator role.