Top Bar

The Top Bar is the main navigation area at the top of TeamIDE. It lets you select your GitHub account, repository, branch, and project to set the working context for the entire application.

Overview

The Top Bar contains four dropdown selectors and action buttons:

Your selections persist across sessions - TeamIDE remembers your last owner, repository, and branch.

Owner Selector

The leftmost dropdown lets you choose which GitHub account to work with.

Options

All Owners Mode

When “All Owners” is selected: - Repositories are grouped by owner with avatars - Recent repositories appear at the top (if enabled) - You can work across multiple accounts without switching

Local Mode

When “Local” is selected: - Only shows repositories imported from your local filesystem - No GitHub connection required - Useful for working with local projects

Managing Accounts

To add a GitHub account: 1. Click the Owner selector 2. Click “Add GitHub Account” 3. A dialog appears with a device code 4. Click the link to open GitHub’s device authorization page 5. Enter the code shown in TeamIDE 6. Authorize TeamIDE to access your account 7. The dialog closes automatically when complete

To remove an account: 1. Click the Owner selector 2. Find the account you want to remove 3. Click the logout button next to the account name

Repository Selector

The second dropdown shows available repositories based on your owner selection.

Repository List

Repositories are organized with the most relevant ones first:

1. Cloned repositories - Already downloaded to TeamIDE (shown with folder icon)
2. Other repositories - Available to clone from GitHub

Repository Indicators

Git Status Indicators

For cloned repositories, the selector shows:

Cloning a Repository

When you select a repository that isn’t cloned: 1. A progress dialog appears 2. TeamIDE creates an environment and clones the repository 3. The dialog shows the current operation (creating, cloning, etc.) 4. Once complete, the repository is ready to use

Repository Actions

At the bottom of the repository dropdown:

Branch Selector

The fourth dropdown lets you switch between branches.

Branch List

Branches are organized in two sections:

1. Local Branches - Branches on your machine
2. Remote Branches - Branches on the remote server (if any)

Branch Status

Local branches show their sync status with the remote:

Creating a Branch

1. Click the Branch selector
2. Click “New Branch…”
3. Enter the branch name
4. The new branch is created from your current branch

Project Selector

The third dropdown shows GitHub Projects and TeamIDE Workspaces.

TeamIDE Workspaces

If you’re connected to TeamIDE’s cloud service, workspaces appear at the top:

• Workspaces group related repositories
• Show member count and your role
• Selecting a workspace shows its linked repositories

Roles: - Owner - Full control - Admin - Can manage members and settings - Member - Can access and contribute - Guest - Limited access

GitHub Projects

GitHub Projects v2 appear below workspaces:

• Shows project name and status
• Open projects have a dashboard icon
• Closed/archived projects have an archive icon

Action Buttons

The right side of the Top Bar contains action buttons.

Fetch / Pull / Push Button

This button changes based on your branch’s sync status:

Note: If you have uncommitted changes when pulling, TeamIDE automatically stashes them, pulls, and restores your changes.

Publish Button

Shows when your repository has no remote URL configured:

1. Click “Publish”
2. Choose to create on GitHub or add a custom remote URL
3. For GitHub: Select owner, enter name, choose public/private
4. Click Publish to push your code

Connection Status

The cloud icon shows your TeamIDE connection status:

Collapse Button

Click the collapse button (far right) to hide the Top Bar and maximize your workspace. Click again to restore it.

Importing Local Repositories

To work with a repository from your local filesystem:

1. Click the Repository selector
2. Click “Import Local Repository…”
3. Select a folder from your computer
4. TeamIDE uploads the folder contents
5. The repository appears in your Local repositories

Note: TeamIDE respects .gitignore patterns when importing.

Publishing Local Repositories

To publish a local repository to GitHub:

1. Select a local repository with no remote
2. Click the “Publish” button
3. Choose “Create on GitHub” or “Add Remote URL”

Create on GitHub

1. Select the owner (your user or an organization)
2. Enter a repository name
3. Optionally add a description
4. Choose Public or Private (default)
5. Click “Create & Push”

Add Remote URL

1. Paste the Git remote URL
2. Click “Add Remote & Push”

Recent Repositories

When “All Owners” is selected, recently accessed repositories appear at the top of the list for quick access.

To disable recent repositories: 1. Open Settings 2. Navigate to General 3. Toggle off “Show Recent Repositories”

Keyboard Shortcuts

Tips

• Quick switching: Use “All Owners” mode to quickly switch between repositories from different accounts
• Status at a glance: Check the git status indicators to see if you have uncommitted or unpushed changes
• Stay in sync: Click “Fetch Origin” regularly to check for remote changes
• Local development: Use “Import Local Repository” to work on projects not hosted on GitHub

Related

• Code Module - File editing after selecting a repository
• Terminal Module - Run commands in your repository
• Authentication - Managing GitHub accounts

Changelog