Repositories
Find, browse, and manage repositories on gitdb.co — files, README, commits, branches and tags, the default branch, and repository settings.
Find your repositories
- Dashboard. Your home page lists Top repositories and a Home feed of "Recently updated repositories you can access". Until you have a repository, it shows Create repository →.
- Search. The search box in the top bar finds repositories by name and description. Type at least two characters, then pick a result (arrow keys and Enter work too). The ⌘K keyboard shortcut shown in the box is coming soon.
- Organization page.
gitdb.co/<org>lists that organization's repositories. See Organizations.
The repository page
Every repository lives at gitdb.co/<owner>/<repo>. The header shows a Private badge and five
tabs:
| Tab | What you find there |
|---|---|
| Code | The file tree, the latest commit, and the README |
| Commits | The commit history of a branch |
| Branches | All branches and tags |
| Pull requests | Open, closed, and merged pull requests. See Pull requests |
| Settings | Repository settings |
The Watch, Fork, and Star buttons are coming soon.
Browse code
The Code tab has two panes:
- File tree on the left, with the branch/tag switcher at the top and a Go to file box that filters the tree by file name. Click a folder to expand it, or a file to open it.
- README on the right. gitdb.co renders the
README.mdat the root of the branch with GitHub-style Markdown: tables, task lists, alerts such as[!NOTE]and[!WARNING], and syntax highlighting. Relative image paths and relative links point into the same repository. If there is noREADME.md, the pane says "This repository has no README."
Above the README, the right pane shows the repository's AST indexing status (see AST indexing) and the latest commit: author, message, short SHA, and time. On narrow screens the two panes stack.
Switch branches and tags
Open the branch switcher to see Branches · n and Tags · n. Type in Find branch (or Find tag) to filter, then pick a ref. The default branch is marked default.
If you're inside a folder, switching keeps you in the same folder on the new branch. If you're viewing a file, switching takes you to the root of the new branch, because the file might not exist there.
View a file
Text files open with syntax highlighting and line numbers. The file header shows the file's name, line count, and size, plus these buttons:
| Button | What it does |
|---|---|
| Raw | Opens the file's raw contents in a new tab |
| Blame | Coming soon |
| History | Lists the commits that changed this file ("History for …"), with Load more for older ones |
Link to lines. Click a line number to highlight it; the address bar gets #L42. Shift-click a
second line number to highlight a range (#L42-L51). Share the URL and the same lines open
highlighted.
Other kinds of files:
- Images show a preview with a Download button.
- Binary files, and text files larger than 1 MiB, show "Binary file — (size)" and a View raw button instead of the contents.
- Git LFS files show "Stored with Git LFS" with the object's size. Downloading LFS objects from the web is coming soon.
Commits
The Commits tab lists a branch's commits, newest first, 30 per page. Use Older and Newer to page through them.
Click a commit to open it. The commit page shows the full message, the author and time, the short SHA, the parent commit(s), and every changed file with its additions and deletions. Switch the diff between Unified and Split views.
Branches and tags
The Branches tab has a BRANCHES table and, if the repository has tags, a TAGS table. Each row shows the name, the last commit's short SHA, and when it was updated. A badge marks the default branch.
Branches are created by pushing them with Git. To protect a branch, see Branch protection.
Default branch
The default branch is "the branch checked out on git clone and shown on the repository home." You
can change it in three places:
- Branches tab: click Set as default next to a branch.
- Settings → Branches: pick a branch under Default branch and click UPDATE.
- Settings → General: edit the Default branch field and click SAVE CHANGES →.
If the first branch pushed to a repository isn't main or master, the repository starts without a
default branch and the Branches tab shows No default branch is set until you choose one.
Repository settings
Open the Settings tab. The General page has:
- Repository name: shown read-only. "Repository renaming is not supported yet."
- Description: up to 1024 characters.
- Default branch: see above.
- Visibility: Private — Only org members can access. Public repositories are coming soon.
Click SAVE CHANGES → to save.
Other settings pages:
- Branches: the default branch and branch protection rules.
- Webhooks: notifications to your own services.
- Access control and Audit log (under Security, shown only to organization owners and admins): read access rules for this repository and its audit log.
Delete a repository
At the bottom of Settings → General, the Danger Zone has Delete this repository: "Once you delete a repository, there is no going back. Please be certain."
- Type the repository's name into the confirmation box.
- Click DELETE →.
You're taken back to your dashboard.