Folders & address prefixes

When you have more than a handful of sites, folders keep them tidy. A folder does two things: it groups related projects, and it can put a shared prefix in front of their addresses.

Create a folder

On your projects page, click New folder. You give it:

• A name: just for you, to recognise it in the list (e.g. Client work, AI experiments).
• An address prefix: added in front of every project you put inside.

How the prefix shapes addresses

Say your folder has the prefix acme. A project called pricing inside that folder goes live at:

acme-pricing.trybailey.app

The prefix and the project name are joined with a hyphen. Put another project landing in the same folder and it becomes acme-landing.trybailey.app: a clear family of addresses.

The prefix can’t change later

A folder’s prefix is fixed once created. It’s part of every address inside the folder, and addresses are meant to be stable, so Bailey doesn’t let you rewrite them all at once. Pick the prefix you’ll be happy with. (The folder’s name you can rename anytime.)

Moving a project in or out

Open a project, go to Settings, and change its Folder. Moving it:

• Updates its address to match the new folder’s prefix (or drops the prefix if you move it out to the root).
• Changes the live address: the old one stops working. Bailey warns you before you save.

Deleting a folder

You can only delete a folder once it’s empty. Move its projects out (or delete them) first. This is on purpose: deleting a folder can never silently take sites offline.

---

For developers

The prefix is composed server-side into an effective subdomain (prefix-label), which is the real routing key and must be globally unique and valid (3–63 chars, [a-z0-9-], no reserved words). The stable internal app_id never changes when you rename or move; content follows the app_id, not the address.