How Lucidity works

1. Sign up, then create an organisation (billing and members live here).
2. Add a workspace from the + in the top bar, or install a blueprint from the Marketplace.
3. Open Desk — that’s the home screen for the selected workspace.
4. Edit content, apply a style, then publish from Deployments.

The top bar always shows which organisation and workspace you are editing. Switching either one changes every Studio page to that site.

The AI / Basic / Expert switch in the top bar hides or shows sidebar tools. Expert-only pages stay reachable by URL.

• Basic — content, media, styling, publish, domains, billing, marketplace.
• AI — prompt-first Desk plus styling, publish, domains, and the full AI builder.
• Expert — schemas, templates, API keys, webhooks, environments, and admin.

Desk is the workspace home. In Basic and Expert it lists your content types so you can open documents or create a new one. In AI mode it is a prompt box: describe a change (add a page, restyle, fill copy) and Lucidity routes that to the right Studio tool.

Dashboard

Organisations own workspaces, members, invites, and the subscription. The dashboard shows usage (workspaces, documents, API and AI today), team roles, and organisation settings such as name and slug. Premium plans can white-label the CMS name and login screen.

Plan & billing

Free, Basic (£4.99/mo), and Premium (£6.99/mo) set organisation and workspace limits. Owners upgrade through Stripe Checkout and manage the subscription in the Customer Portal. Upgrade here before you hit a create limit.

Overview

A workspace is one site: its own schemas, documents, media, API keys, templates, and deployments. Overview is a jump list into those areas plus counts at a glance.

Environments

Each workspace has Development and Production. Pair them with API keys: Production keys return published content only; Development or Preview keys can request drafts with ?preview=true.

Schemas are content types (page, post, service, and so on). Each schema has a name, title, and fields. Studio generates the document form from those fields. Create them visually, paste Sanity-style JSON, or let AI draft them from a short description.

Turn Show on site on for fields that should appear on the published HTML site. Leave it off for Studio-only fields such as SEO helpers.

Once a schema exists, it appears under Content in the sidebar. Open a type to list documents, then create or edit. Documents have draft and published JSON. Save keeps a draft; Publish makes it available on the hosted site and on /api/query. Archive hides it without deleting history.

Styling

Pick a theme and layout for the hosted site. Applying a style updates every page and republishes automatically. Use this when you want a look without editing HTML.

Templates

Expert HTML templates with Mustache placeholders, optional JSON-LD, and a bound schema type. Needed for custom page markup and for some export/publish paths.

Media

Upload files to this workspace’s Supabase Storage folder, or search Unsplash for free photos. Uploads and Unsplash remain separate libraries.

API keys

Create keys scoped to the current workspace. Send Authorization: Bearer YOUR_KEY or X-Api-Key: YOUR_KEY to query published content from your own frontend. See the interactive API reference.

API usage

Request logs for the workspace — counts, status codes, and recent calls for debugging.

Deployments

Publish Website builds a hosted static HTML site for the workspace slug (open it from the Site button in the top bar). You can also pick a framework and export a project zip for Nuxt, Next.js, and others. Fine-tune export options under Settings → Export.

Domains

Every workspace gets a platform subdomain. Add a custom hostname, then complete TXT or CNAME verification. Mark one domain as primary for canonical URLs.

Webhooks

POST to n8n or any URL when documents, schemas, media, or deployments change. Copy the signing secret when you create the hook — it is shown only once.

AI

Describe a business to draft schemas, starter content, templates, and a first publish in one pass, or generate schemas only. The Desk prompt in AI mode is the shorter version of this page.

Marketplace

Install a complete website blueprint — schemas, sample content, theme, and a first deploy — instead of starting from a blank workspace. Admins can publish the current workspace as a template.

Workspace-level configuration, grouped as:

• General — name, slug, logo, locale, timezone.
• Publishing — draft, preview, and list defaults.
• Export — target framework and README/env options for the zip export.
• SEO — titles, meta, social cards, sitemap.
• Domains, API, AI, Deployments, Media, Integrations, Security — matching Studio tools, plus CORS, rate limits, analytics, and audit options.

Visible only to platform admins. Inspect organisations and users, edit or delete records, and manage marketplace templates. Set LUCIDITY_ADMIN_USER_ID to your user UUID to enable it.

Published documents are available without signing into Studio. Create a key in API keys, then call:

GET /api/query?type=post
GET /api/query?type=post&slug=hello-world
GET /api/query/schema-types
GET /api/render?workspace=your-slug&template=page&type=page&slug=home

Full request/response shapes, try-it-out, and OpenAPI live on the API docs page.