login

Sign in to Based Page via browser-based email verification.

npx based-page login

Opens your default browser to the Based Page sign-in page. Enter your email, verify the one-time code, and you're authenticated. The entire flow takes about 15 seconds.

Credentials are saved to ~/.based-page/credentials.json and reused automatically in future CLI runs.

Agent claim on login

If you've deployed without logging in (agent identity auto-provisioning), running login will automatically claim those deployments into your account:

Logged in as you@example.com
Claimed agent deploys: my-app, other-site

---

logout

Sign out and clear stored credentials.

npx based-page logout

Deletes ~/.based-page/credentials.json. You'll need to run login again for future authenticated operations.

---

whoami

Show the currently authenticated user.

npx based-page whoami

Output:

Signed in as you@example.com

Or, if not authenticated:

Not logged in. Run `npx based-page login` to authenticate.

---

CI/CD: API Key Auth

For headless environments (GitHub Actions, Docker, etc.), use an environment variable instead of browser login:

export BASED_PAGE_API_KEY=bp_your_api_key_here
npx based-page deploy --file dist/index.html --slug my-app

Generate an API key from the Based Page dashboard.

Agent Auto-Provisioning

If you deploy without any credentials configured, Based Page automatically provisions a temporary agent identity. The deploy succeeds immediately - no login, no config. The agent identity is tied to ~/.based-page/credentials.json and can be claimed into a real account later with login.

This means npx based-page deploy always works out of the box.