Cofounder Docs

Publishing

Understand how staging and production publishing work in Cofounder.

Publishing

Use Cofounder publishing for the marketing website and other supported business surfaces it builds around your product. Publish the core product through your own engineering and hosting workflow.

Some existing workspaces also show a managed app target. That does not change Cofounder's product boundary. See What Cofounder Does.

Cofounder has two separate ship steps:

  1. Publish to staging (preview) — put finished agent work into the shared review environment
  2. Publish to production — promote what is already on staging to the live app or website

For the staging step, the Engineer (or another coding agent) can request a deploy when the work is ready. You select Approve for that handoff. For production, you (or Cofounder) use the workspace Publish flow.

Staging Vs Production

Staging is the shared place to review and test changes before customers see them.

  • it is the default review surface for the managed app and marketing site
  • it is where you check that a change looks and behaves right after an agent finishes work
  • for app work, it can use a separate staging backend so review does not touch live data

Production is what real users hit.

  • it is the live app or website
  • only promote to production after staging looks good
  • for app work, it continues using the production backend

The Two Steps

1. Publish to staging

How it works at a high level:

  1. An agent finishes work in its sandbox.
  2. The agent requests a deploy for the app or marketing target.
  3. Cofounder prepares the handoff and asks you to approve.
  4. In the agent workspace, select Approve (or reject).
  5. On approval, the change lands on staging.

Once staging is updated:

  • the managed staging / preview deployment refreshes for that target
  • for app work, staging continues to use the staging backend
  • for database migrations, the staging apply path can run after the change reaches staging

Requesting a deploy does not publish production. It only ships work into staging.

See Requesting a deploy.

2. Publish to production

Publishing to production is how changes move from staging to the live app or website.

You can publish from the publish button in Canvas, or ask Cofounder to publish for you.

In either case, Cofounder runs the publish flow for the app or marketing target you selected, and gives you a place to review readiness before the live environment updates.

Once production is updated:

  • the live app or website reflects the published changes
  • for app migrations included in that publish, production migrations can run after the live promote

What Agents Should Use

GoalFlow
Ship finished website or business-surface work to stagingRequest a deploy, then select Approve
Ship staging to productionWorkspace Publish / ask Cofounder to publish

After finishing code changes, agents should request a deploy as the normal handoff into staging. Staging is the review step. Production is the live promote.

Environments

Publishing uses the staging and production environments that Cofounder sets up during onboarding.

See Environments.

Next Steps