Orbit
Search ⌘K
Documentation

Projects

Turn local folders into Orbit projects.

Add a folder, let Orbit analyze it, then run and inspect the project from the same workspace.

Dashboard

Scan running state before opening a project.

The dashboard lists every project with status, framework, package manager, branch state, domain, and row actions for browser, logs, metrics, start, and stop.

  1. Use All Projects for the full list.
  2. Use Running when you only need active projects.
  3. Double-click a row to open the project detail view.
  4. Use row actions for browser, logs, metrics, start, and stop without opening the detail view.
Orbit projects dashboard
The dashboard is the fastest way to compare project state across the workspace.

Use the table when you need a workspace-level decision: which app is running, which command owns it, and which action can be taken from the row.

Add project

Point Orbit at the project folder.

The add dialog analyzes the path, detects framework, package manager, dev command, and suggested domain, then warns when the layout is ambiguous or dependencies are missing.

  1. Open Add Project from the toolbar.
  2. Browse for the folder or paste the path.
  3. Review the detected framework, manager, command, and domain.
  4. Let Orbit install missing dependencies when the project needs them.
Orbit Add Project dialog
Orbit shows the detected command and domain before the project is added.

Review the detected framework, manager, command, and local domain before saving. A wrong value here becomes the runtime contract for the project.

Project detail

The selected project owns its runtime context.

Project detail shows the project domain, HTTPS state, framework, package manager, detected port, uptime, runtime actions, and the tabs that hold the rest of the workflow.

  1. Start, stop, or restart from the action row.
  2. Open the domain from the title area to use the proxied project URL.
  3. Use Details for resolved metadata and the project path.
  4. Use Env and Terminal when the fix belongs inside the project folder.
Orbit project detail view
Project detail keeps runtime state, domain, actions, and metadata attached to one selected app.

Start here when a single app needs attention. The header shows domain, HTTPS state, status, detected port, and direct actions.

Environment

Edit variables beside the runtime that reads them.

The Env tab keeps project-specific configuration attached to the selected app, so local values can be reviewed without switching to another tool.

  1. Open the project detail view.
  2. Switch to Env when the fix is configuration.
  3. Edit the value and save before restarting the project.
Orbit project environment tab
Env keeps project-specific variables beside the runtime that consumes them.

Use Env when the fix is configuration, not code. Orbit keeps project variables editable beside the runtime that reads them.

Terminal

Run commands from the project root.

The Terminal tab opens in the selected folder, keeping package manager, framework, and database commands aligned with the project Orbit detected.

  1. Open Terminal when a fix needs a local command.
  2. Run package manager or framework commands from the detected root.
  3. Return to Logs or Requests to confirm the result.
Orbit project terminal tab
Terminal opens in the selected project when the fix needs a local command.

Use Terminal when the next step is a package manager, framework, or database command inside the project folder.