Docs / Products and the portfolio

Products and the portfolio

A Bedrock workspace can hold a portfolio of products. A product is a container for everything that belongs to one thing you’re building: its documents, prompts, releases, features, tasks, and inbox. If you only work on one project, you’ll have a single product and rarely think about this — but the moment you juggle more than one, products keep them cleanly separated.

The product switcher

The colour-coded avatar at the top of the left rail is the product switcher. It shows the active product’s initial and colour. Click it to:

  • Switch between products.
  • Create a new product (name, colour, and optional icon).
  • Edit a product (rename, recolour, change status).
  • Archive a product to hide it from the main list.
  • Open a product’s connected folders (see Connected folders).

A workspace always has at least one product; if none exists, Bedrock creates a default product for you.

Creating a product

  1. Click the product switcher.
  2. Click New product (or the + button).
  3. Enter a name (e.g. “my-backend”).
  4. Pick a colour — used as the product’s accent in the rail and headers.
  5. Pick an optional icon.
  6. Click Create.

Bedrock creates a products/my-backend/ folder inside the workspace and sets this product as active.

Everything is scoped per product

When you select a product, the whole app follows:

  • The dashboard shows that product’s releases, tasks, and inbox.
  • The library lists that product’s documents; each product owns its own docs folder (products/<slug>/).
  • Prompts, releases, features, tasks, and inbox items all belong to the active product.

This scoping means you can keep separate products side by side with no mixing.

Product status

Status Meaning
Active Shown prominently in the switcher, data is live
Paused Shown but visually muted; useful for work on hold
Archived Hidden from the main switcher; accessible via “Show archived”

Where it’s stored

Products and their work are stored as plain JSON inside .bedrock/ in your workspace (products.json, releases.json, and so on). Everything stays on your disk — no account, nothing leaves your machine. Documents remain ordinary markdown files you can read and edit with any tool.

Tips

  • Keep products in one workspace when they’re tightly related (same repo, shared docs). Use separate workspaces for completely unrelated projects.
  • Use Paused for products you’re not actively working on but still want to track.
  • The product colour helps you tell products apart in the switcher and rail.

Get release notes

An email when a new build ships or a major feature lands. A few times a quarter — never your inbox sold.

You're on the list — watch for a confirmation email.