Website builder service

Discovery, templates, and private publishing

Use Ensemble as a public discovery client for blocks, recipes, themes, working templates, clone manifests, quality evidence, and the Cloud Elephants publishing boundary.

builder guidepublic discoveryprivate publishStart tenant onboarding
Buyer funnel

Discovery should end in Cloud Elephants tenant setup

Open onboarding
Browse

Start with examples

A buyer compares full starter sites before learning words like clone manifest, recipe, or CMS payload.

Commit

Capture intent in onboarding

The favorite starter can pass template id, industry, theme, recipe, pages, forms, listings, embeds, assets, and static-readiness into the Cloud Elephants new-tenant intake.

Build

Keep developer evidence nearby

After the buyer chooses a direction, developers use the APIs, clone payloads, and publish docs to create the tenant site.

Discovery map

Public routes a builder can crawl

16 routes
/docs/docs/comprehensive-api/docs/website-builder/example-sites/example-sites/{template}/block-catalog/block-catalog/{block}/recipes/{recipe}/themes/themes/{theme}/recipes/templates/demo-sites/page-templates/demo-sites/page-templates/recipes/{recipe}/api/ensemble/templates/sitemap.xml/llms.txt
Machine-readable APIs

Template and readiness endpoints

clone-ready
API

Template discovery index

Single API entrypoint for finding page templates, site-template groups, starter sites, clone manifest examples, conversion handoff fields, and future webhook context.

Open API
API

Page templates

Individual CMS page families with slot models, compatible recipes, colorway routes, component coverage, polish audit, and optional clone manifests.

Open API
API

Site templates

Multi-page template groups assembled from compatible page templates, optional globals, aggregate component coverage, and site-level clone manifest.

Open API
API

Example sites

Complete working starter sites with content roots, pages, globals, assets, forms, validation commands, and static deployment notes.

Open API
API

Themes

Theme catalog with source filters, Cloud Elephants coverage, preview URLs, swatches, layout settings, accessibility metadata, and optional full theme payloads.

Open API
API

Recipes

Recipe catalog from the template recipe review model, including coverage status, polish summaries, colorways, gaps, and optional compatible templates.

Open API
API

Quality gate

Machine-readable readiness for authorable blocks, page templates, site templates, recipe passports, accessibility, responsive behavior, and runtime portability.

Open API
Outcome picker

Live filtered discovery examples

Open picker
Pick

Full starter site

Start from a complete industry site when the builder needs routes, forms, assets, globals, and deployment notes together.

Open filtered API
Pick

Playful candy shop

Use Elsie's Hard Candies when a buyer wants a playful specialty-retail catalog, gift inquiry funnel, and JSON-ready configuration handoff.

Open filtered API
Pick

Recipe-family preview

Filter by source recipe id while rendered previews preserve that id and emit shared runtime family classes such as glass, neumorphic, or skeuomorphic.

Open filtered API
Pick

Single lead page

Find the best individual page by industry fit, use case, and visitor intent before fetching a clone manifest.

Open filtered API
Pick

Site-template group

Fetch the common page-template group when the builder wants compatible pages ranked by aggregate selection metadata.

Open filtered API
Pick

Funnel preset

Use the common-funnel template when the outcome is guided capture, then choose a lead-flow preset from its existing lead_funnel_flows metadata.

Open filtered API
Builder flow

From public discovery to tenant build

12 steps
1

Discover routes through /llms.txt, /sitemap.xml, and the docs index.

2

Query the quality gate before selecting templates.

3

Choose by outcome: full starter site, single page, site-template group, or common-funnel preset.

4

Use /example-sites/:template_id#site-spec-builder when the buyer should submit an ensemble.site-spec.v0 JSON configuration to a third-party service.

5

Preserve selected source recipe ids such as glass-product, soft-neumorphic, or tactile-service-ledger; rendered previews add the matching runtime family classes for visual QA.

6

Send buyers who are ready to act into Cloud Elephants new-tenant onboarding with the selected starter-site context.

7

Query theme and recipe catalogs when the buyer needs to compare look, content density, or coverage gaps.

8

Fetch a detail payload with pages, globals, and clone manifest when ready to copy.

9

Replace brand, navigation, copy, images, form ids, theme tokens, SEO metadata, and routes while preserving Ensemble document structure.

10

Store the generated snapshot in the upstream Cloud Elephants CMS.

11

Let the CMS submit the signed publish request to the private build service.

12

Read generated-root and S3 publish receipts after the build completes.

Private handoff

Publish through the Cloud Elephants CMS

POST /api/ensemble/cms/publish

The website builder should generate or update CMS-owned snapshots. The upstream Cloud Elephants CMS then sends the HMAC-signed publish request to the private Ensemble build service. Production tenant delivery uses publish_target=s3 and verifies the tenant public URL after upload.

generated/build-webhooks/<request_id>.jsongenerated/build-webhooks/<request_id>.loggenerated/snapshots/<snapshot_id>/snapshot.jsongenerated/builds/<tenant_slug>/<request_id>/static-sitegenerated/tenant-builds/<tenant_id>/<request_id>.json