Browser Module

Embedded web browser with multi-tab support and TeamIDE SSO integration

Overview

The Browser module provides a full-featured embedded web browser within TeamIDE. It supports:

  • Multiple concurrent browser tabs
  • URL navigation with history (back/forward)
  • Per-repository tab persistence (tabs survive repo switching)
  • Automatic SSO token injection for TeamIDE hosted deployments
  • External link interception from other modules

Accessing the Browser

Open the Browser module by clicking the Browser icon (globe) in the module tab bar.

The browser works without a repository selected, making it useful for general web browsing and documentation.

Tab Management

Opening Tabs

  • Click the New Tab button in the left sidebar
  • Click any external link in TeamIDE (links are intercepted and opened in the browser)
  • Open hosted deployments from the Workspace module

New tabs open to https://teamide.dev by default.

Switching Tabs

  • Click a tab in the tab bar (top of the browser panel)
  • Click a tab in the left sidebar navigation

Closing Tabs

  • Hover over a tab and click the X button
  • When closing the active tab, the browser automatically switches to an adjacent tab

Tab Bar

The tab bar at the top shows all open tabs:

Element Description
Spinner Shown while page is loading
Globe icon Shown when page is loaded
Title Page title (truncated if too long)
Close button Appears on hover to close the tab

URL Bar

The toolbar contains a URL input field:

  • Type a URL and press Enter to navigate
  • URLs without a protocol automatically get https:// added
  • The lock icon indicates HTTPS; the globe icon indicates HTTP
Button Description
← (Back) Go to previous page in history
→ (Forward) Go to next page in history
↻ (Refresh) Reload the current page
⊡ (Stop) Stop loading (shown while page is loading)
↗ (External) Open current URL in your system browser

Note: Back/forward navigation may be limited for some sites due to browser security restrictions.

Loading Indicator

A progress bar appears below the toolbar while pages are loading.

The left panel provides an alternative way to manage tabs:

  • New Tab button at the top
  • List of all open tabs with status icons
  • Click any tab to switch to it
  • Hover and click X to close a tab
  • Selected tab is highlighted

Per-Repository Persistence

Browser tabs are saved per repository:

  1. Open several tabs while working in Repository A
  2. Switch to Repository B (your tabs are saved)
  3. Switch back to Repository A (your tabs are restored)

This lets you maintain different browser contexts for different projects.

TeamIDE SSO Integration

When viewing URLs on *.teamide.dev domains (such as hosted branch deployments), the browser automatically injects your TeamIDE authentication token. This allows you to:

  • View password-protected hosted deployments
  • Access authenticated TeamIDE services
  • Test deployed applications without manual login

The token is only injected for TeamIDE domains and is not sent to other websites.

When you click an external link (http/https) anywhere in TeamIDE:

  1. The link is intercepted
  2. The Browser module opens automatically
  3. A new tab is created with the link URL

This keeps you within TeamIDE instead of switching to an external browser.

Opening from Other Modules

From Workspace Module

Hosted branch deployments have an Open link that opens the deployment URL in the Browser module.

From Code Module

Clicking URLs in code files or documentation opens them in the Browser module.

Security

The embedded browser uses sandboxing for security:

  • Scripts can run but cannot access TeamIDE’s internal state
  • Forms and popups are allowed for normal web functionality
  • Each tab runs in isolation

Keyboard Shortcuts

Shortcut Action
Enter (in URL bar) Navigate to URL

Limitations

  • History navigation: Some websites prevent iframe history access due to security policies. Back/forward may not work on all sites.
  • Page titles: Some websites block title access. The hostname is shown instead.
  • Downloads: File downloads may not work in the embedded browser. Use the external open button for download-heavy sites.

Changelog

Date Change
2026-02-02 Initial documentation