What is Lucerna?
Lucerna is one platform composed of multiple products. This site documents its developer surface — the pieces you integrate from your own code:
- Gates — feature flags, kill switches and experiments, checked from your backend or your UI.
- Identity — one object that answers "who is the current user?" for every SDK, and keeps your People profiles in sync by itself.
- Waitlist — capture signups and redeem invites from your own landing page and join flow.
Everything else — dashboards, analytics, entry management, templates — lives in the Lucerna dashboard and is not part of this public surface.
SDKs first
Where a packaged SDK exists, the package is the integration — it owns polling, caching, retries, batching and fail-open behavior, so you never hand-roll HTTP against those endpoints:
| Product | Where | Use |
|---|---|---|
| Gates | Node & edge | @lucerna-dev/gates-node |
| Gates | Browser | @lucerna-dev/gates-browser |
| Identity | Everywhere | @lucerna-dev/identity |
The raw endpoints these packages speak are not documented for direct use — they're an implementation detail the SDKs are free to evolve.
The Waitlist has no SDK by design: it's three small JSON-over-HTTPS endpoints you can call from any language with curl and a couple of lines of code. That's the one surface documented as a REST API (plus the erasure endpoint for GDPR requests).
Base URL
Every API call — yours or an SDK's — goes to:
https://api.uselucerna.appThe public surface lives under the /sdk/v1/… prefix. Requests and responses are always JSON.
One credential model
All authenticated calls send a single header:
Authorization: Bearer <key>A key pins one workspace and one environment — a production key serves production rules, so there's no separate environment setting anywhere. The key's prefix tells you (and the SDKs, which enforce it) what it's for: secret ck_srv_… server keys, publishable ck_client_… browser keys, and scoped ck_key_… keys with exactly the grants you choose.
Read the details in Authentication, and how failures look in Errors.
Next
- Authentication — the three key flavors and grants.
- Gates quickstart — first flag check in under a minute.
- Identity quickstart — identify a user and pass them everywhere.
- Waitlist quickstart — first signup in under a minute.