Skip to Content
Getting StartedFirst Steps

First Steps

Once you have the Shipmore Core repo and environment set up, follow the steps below.

Quick path: pnpm install → copy .env.example to .env and set required vars → pnpm dev → open /admin and create a tenant.

Install and run

In the project root:

pnpm install pnpm dev

The dev server starts (default port 3000). Keep it running while you configure your first tenant.

URLs

  • Admin panelhttp://localhost:3000/admin (or your base URL + /admin). Use this to manage tenants, pages, users, and media.
  • Docshttp://localhost:3000/docs. This documentation.
  • Frontend (tenant site) — Depends on the tenant’s domain. After you configure a tenant with domain localhost:3000, open http://localhost:3000 to see that tenant’s site. Other domains (e.g. demo.local:3000) work once you add a tenant with that domain.

First login

If the database is empty, the first time you open /admin you’ll be prompted to create an admin user. Use a secure password; this user can manage all Payload collections. For more on Payload auth, see Payload: Authentication .

First edit

A good first edit is to create a tenant: go to Admin → Tenants → Create New. Set a name (e.g. “My Site”) and domain (e.g. localhost:3000 for local dev). Save, then open the frontend at that domain. Details are in Configure Tenants.

You can also edit a Page in Payload to change the homepage or add a new page and view it on the tenant’s frontend.