Pluma
Docs index
docs/guides/create-a-site.md View markdown →

Step 1 · Create the site

Each site in Pluma is a space: it has its own content, team, keys and deploys. A person does this step, because creating the site sets who the owner is.

Create the account

  1. Go to /signup.
  2. Enter your name, your email and a password of at least 10 characters.
  3. Optional: the name of your organization (who pays). If you leave it empty, your name is used.

Once the account is created you are signed in, and Pluma takes you to create your first site.

Create the site

  1. On /spaces/new, enter the site name. Example: "Acton Estero".
  2. Pluma suggests the slug from the name (acton-estero). You can change it.
  3. Save.

The slug is the part of the site that shows up in API URLs and in your site's docs. Rules:

  • Only lowercase letters, numbers and hyphens. Between 3 and 40 characters.
  • Unique across all of Pluma.
  • Choose it well: changing it later breaks the URLs your site already uses.

What happens when you create it

  • You become the site owner.
  • The main environment is created. That is where all content lives in v1.
  • The 14-day trial starts. No card required.
  • Step 1 of the checklist is done, and the dashboard shows you step 2: invite your agent.

The site dashboard

At /spaces/<slug> you see:

  • The name, the production domain and the status of the last deploy.
  • The 5-step checklist. Each step checks itself off when Pluma sees it happened; there is no "done" button.
  • Three cards: Content, Agents and keys, and Activity (who did what, human or agent).

Possible errors

Message What to do
"That slug is already taken" Choose another one. Add the city or a number.
"The slug can only contain lowercase letters, numbers and hyphens" Remove spaces, capital letters and accents.
"An account with that email already exists" Sign in at /session/new, or reset your password.