Working with repositories

Creating a repository

To create a new repository:

1. Click the "New" button in the top navigation.
2. Enter a repository name (lowercase, with hyphens or underscores).
3. Add a description (optional).
4. Choose visibility (public or private — private repos are restricted to you and anyone you explicitly invite).
5. Click "Create repository."

Cloning your repository

Using HTTPS

The simplest method (works with just a password):

git clone https://scriptreeapps.com/_git/YOUR_USERNAME/REPO_NAME.git

Using SSH (recommended for frequent commits)

SSH is more secure and doesn't require entering your password each time. First, set up your SSH keys.

git clone git@scriptreeapps.com:YOUR_USERNAME/REPO_NAME.git

SSH configuration for non-standard ports

The developer portal's Git server runs on port 2222 (non-standard for SSH). If you're cloning with SSH, add this to your ~/.ssh/configto avoid having to specify the port manually:

Host scriptreeapps.com
  Hostname scriptreeapps.com
  Port 2222
  User git
  IdentityFile ~/.ssh/id_rsa

After adding this, you can use the simpler syntax:

git clone git@scriptreeapps.com:YOUR_USERNAME/REPO_NAME.git

Pushing changes

Work on your repository locally, commit your changes, and push them back:

git add .
git commit -m "Description of changes"
git push

Large file support (Git LFS)

The developer portal has Git LFS (Large File Support) enabled for files that are commonly large in app development:

• *.psd — Photoshop files
• *.zip — Archives
• *.exe, *.dll — Windows binaries
• *.bin — Binary files
• *.sldprt, *.sldasm, *.slddrw — SolidWorks files

Git LFS is enabled by default. When you push a file matching one of these patterns, Git automatically stores it in LFS. You don't need to do anything special.

Browsing files on the web

You don't need to clone to view your files. The developer portal has a built-in file browser:

1. Go to your repository page on the developer portal.
2. Click on a branch name to switch branches.
3. Browse the folder structure. Click any file to view its contents.
4. For binary or large files, you'll see a "Download" button to fetch the raw file.

Branch management

Create and switch between branches locally:

# Create a new branch
git checkout -b feature-name

# Push the branch to the developer portal
git push -u origin feature-name

# Switch branches
git checkout branch-name

Viewing repository settings

Each repository has a Settings page where you can:

• Edit the repository description
• Change visibility (public/private)
• View clone URLs
• Manage webhooks (if CI is enabled)

Private vs. public repositories

• Public: Anyone can view your code. Use this for open-source apps or to make your app discoverable.
• Private: Only you can see the code (unless you invite collaborators). Use this for proprietary app source code.

Frequently asked questions

Can I use the same SSH key on multiple machines?

Yes, your public key can be used on any number of machines. Keep your private key secure and don't share it.

Can I delete a repository?

Yes, go to the repository's Settings page and scroll to "Danger Zone." Only the repository owner can delete it.

How large can a repository be?

Repositories can be quite large, but use Git LFS for files larger than 100 MB. Contact support if you need a quota increase.

Do you have Git submodules or monorepo support?

Yes, submodules work normally. The developer portal's Git service supports standard Git workflows.