Reveal Marketplace

The Reveal Marketplace is the fastest way to get a governed semantic layer up and running. Each pack bundles a set of certified reveals — metric definitions written in domain YAML — that map onto the table patterns most teams already have (orders, events, subscriptions). Install a pack and Celiq creates a new domain in your workspace, certifies its reveals, and makes them immediately available to Orion, Discover, and Mosaics.

What is the Marketplace

A pack is a curated, versioned collection of reveals for a particular kind of business. Instead of defining "revenue", "CAC", or "MRR" from scratch, you install a pack authored and certified by Celiq and adapt it to your schema.

Every pack has:

• A name and description
• A category (Ecommerce, SaaS, or Marketing) and a schema type it expects
• An author (Celiq, for the certified starter packs) and a version
• A list of preview reveals so you can see what you'll get before installing
• An install count showing how many workspaces have used it
• A Certified badge, meaning Celiq has reviewed the metric definitions

Browsing packs

Open the Marketplace pill in the floating nav, or go to /marketplace. You'll see the pack grid with a filter bar at the top:

• All — every available pack
• Ecommerce
• SaaS
• Marketing

Each pack card shows the pack name, its category badge, a short description, the reveals it includes (shown as chips, with a "+N more" chip when there are more than five), the install count, and the Certified badge.

Starter packs

Celiq ships three certified starter packs. Each one is a valid domain YAML definition with reveals and nodes that reference common table patterns.

The Ecommerce Starter expects an orders-style table, SaaS Metrics expects subscriptions and events, and Marketing Analytics expects channel-level spend and events data. After installing, you'll usually need to point the pack's nodes at your real table and column names — Orion can help you do this in Forge.

Installing a pack

1. Find the pack you want in the grid.
2. Review the reveal chips to confirm it covers the metrics you need.
3. Click Install Pack. The button shows a spinner while the pack installs.
4. When it finishes, a success toast appears and the button becomes Installed ✓ (disabled).
5. You're taken to your catalog, where the newly created domain and its certified reveals are ready to query.

Behind the scenes, installing a pack:

• Parses the pack's domain YAML
• Creates a new domain in your workspace
• Marks the pack's reveals as certified for your workspace
• Records the install against your workspace and increments the pack's install count
• Kicks off a background job to auto-generate descriptions for any reveals missing them

Once installed, the reveals behave exactly like reveals you authored yourself: Orion routes to them first (high confidence), Discover lists them in the field picker, and you can edit them in Forge.

What "certified" means

A certified reveal carries a trust signal: Celiq (or whoever authored the pack) has reviewed the metric definition. When Orion answers a question using a certified reveal, the provenance footer shows the semantic layer source and high confidence. You can re-certify, edit, or remove these reveals at any time in Forge — installation is a starting point, not a lock-in.

Viewing installed packs

Your workspace keeps a record of which packs are installed and when. This is surfaced in the Marketplace (installed packs show the Installed ✓ state) and is also available to tools and admins through the Marketplace API.

API

All Marketplace endpoints are workspace-scoped and require authentication.

A successful install returns:

{
  "domain_id": "…",
  "domain_name": "…",
  "reveals_created": 5,
  "certified": 5,
  "message": "Installed \"Ecommerce Starter\" — 5 reveals added to …."
}

Limitations

• Packs assume common table shapes. A starter pack maps onto typical orders, events, or subscriptions tables. If your schema differs, expect to remap node table and column references in Forge after installing.
• Installing creates a new domain — it does not merge. If you already have a revenue reveal, installing a pack that also defines revenue gives you two definitions in separate domains. Decide which one is canonical.
• Reveals are a starting point, not validated against your data. Certification means the metric definition was reviewed, not that it produces correct numbers against your specific warehouse. Always sanity-check the values after install.
• Community pack submission is not yet available. Today all packs are certified and authored by Celiq. Submitting your own packs to the public Marketplace is on the roadmap.