Navigating the Platform

Learn how to move around the Buildpad.ai interface.

Platform Structure

Buildpad.ai is organized in a simple hierarchy. You start at the top and drill down into more specific areas:

• Organization — Your team workspace — contains projects and members.
• Project — An application you’re building — contains environment details, builds, microapps, and workers.
• Microapp — A domain-focused app inside a project, with its own detail and build views.
• Worker — A background process inside a project, with its own builds, logs, and configuration.

The Sidebar

The left sidebar adapts to show relevant navigation links based on where you are:

Global

• Home — Returns to your organizations area.

At the Organization Level

• Overview — Organization details and summary
• Projects — List of all projects
• Members — Team member management
• Roles — Organization role definitions and access control

At the Project Level

• Details — Project information and settings
• DaaS — Cloud environment status
• Builds — Build/deploy history and logs
• Microapps — List and manage microapps in the project
• Workers — Enable and manage background processes. Appears only when the feature is enabled on your instance. See Workers.

At the Microapp Level

• Detail — Microapp metadata and configuration
• Builds — Microapp-specific build/deploy history

At the Worker Level

Shown while you have a specific worker open:

• Detail — Process status, restart, and starter downloads
• Builds — Pipeline history for this worker
• Application Logs — The worker process’s own output
• Environment — The worker’s .env configuration

Admin (Permission-Based)

If you have host-level permissions, an Admin section appears:

• Users
• Host Roles
• Quotas

Sidebar Footer

Two controls sit pinned at the bottom, below the navigation:

• Documentation — Opens the full list of documentation sites (see Finding Documentation).
• Collapse — Shrinks the sidebar to icons only. Hover any icon for its label. The choice is remembered between visits.

Switching Between Scopes

The header provides dropdown switchers to quickly jump between different levels without navigating back through the hierarchy:

• Organization Switcher — Switch between organizations you belong to and see your role in each.
• Project Switcher — Switch between projects within the current organization.
• Microapp Switcher — Switch between microapps in the current project, search microapps, or create a new one.

While you have a worker open, the third switcher becomes a Worker Switcher so you can move between the project’s workers the same way.

The Header

The right side of the header holds two menus.

Help & Documentation

The ? button opens the help menu. Press ⌘ / on macOS or Ctrl / elsewhere to open it from anywhere without reaching for the mouse.

It lists every documentation site plus, on screens that have a guided tour, Replay quick start tour.

Account Menu

Your avatar sits at the far right, with your name and email shown beside it on wider screens so you can confirm which account you’re signed in as at a glance. On narrow screens the identity moves inside the menu. The menu itself holds:

• Account settings — Profile and security settings
• Logout

Finding Documentation

Documentation lives in three places, all reachable from either the help menu in the header or the Documentation item in the sidebar footer:

When you’re on a page with a matching doc set, that entry is marked as relevant so you can jump straight to it. The DaaS pages point at the DaaS docs, microapp pages at the component library.

These three sites map to the three products that make up Buildpad — see The Buildpad Ecosystem for how they relate.

On Mobile

The sidebar becomes an overlay. Tap the hamburger button at the top left to open it, and tap outside it to close. A second row under the header keeps the scope switchers within reach. Tapping Documentation in the sidebar expands the list of sites in place rather than opening a flyout.