Studio

Create or import a project

Start fresh or adopt an existing folder — and what build mode decides.

About 5 minutes

Two ways in

Create scaffolds a new project from a template.

Import adopts a folder that already exists on your host — an existing codebase becomes a Studio project without moving anything.

Build mode is not cosmetic

When a project is created you choose a build mode. It declares how much of the host that project may occupy, and — the part people miss — it drives whether publication is allowed.

Choose it deliberately. Changing it later is a real decision, not a preference toggle.

Steps

  1. Open Studio and choose New project or Import.
  2. Name it after what it does.
  3. Pick the template, or select the folder to adopt.
  4. Set build mode.
  5. Wait for the project to report ready.

You're done when the project opens and its Files tab shows a tree.

Gotchas

  • Project management is owner/admin only. These operations create and destroy working directories on a host and bind git credentials, so a member cannot delete another person's project.
  • Importing does not copy. It adopts the folder in place. Moving that folder afterwards breaks the link — use Change folder rather than moving it behind Studio's back.

Checked against

  • endpoints/studio/projects/create_POST.ts
  • endpoints/studio/projects/build-mode_POST.ts