list

List all active deployments on your account.

npx based-page list

Output

Active deployments (3):

  my-site          https://my-site.based.page          dep_abc123   Updated 2h ago
  acme-launch      https://acme-launch.based.page      dep_def456   Updated 1d ago
  react-app        https://react-app.based.page        dep_ghi789   Updated 3d ago

Options

No options - lists all active deployments for the authenticated account.

---

status

Get full details for a single deployment.

npx based-page status --id <id>

Options

Flag	Description
--id <id>	Deployment ID (required)

Output

Deployment: my-site

  URL:        https://my-site.based.page
  ID:         dep_abc123
  Slug:       my-site
  Title:      My Site
  Status:     active
  SPA mode:   false
  Protected:  false
  Created:    2026-03-10 14:22:01
  Updated:    2026-03-13 09:15:44

Notes

• Both commands require authentication. Run npx based-page login first, or set BASED_PAGE_API_KEY.
• Free plan: up to 5 active deployments. Tear down unused ones to free up slots.