Skip to content

Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.

docs(demo): explain the demo brand to users and contributors (demo brand, part 7) (#1740)

Cihana33dbd072e3b
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index af849f744..8657c8b04 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -164,6 +164,15 @@ We follow [GitHub Flow](https://docs.github.com/en/get-started/using-github/gith
migration, and the other half is applying it to the hosted database. You do
not need to do anything about the label yourself.
+ If the migration adds a table with a `brand_id`, say what the
+ [demo brand](docs/guides/demo-brand.mdx) shows for it: build its rows in a
+ module under `server/src/lib/demo/`, or list it in `SKIPPED` in
+ `server/src/lib/demo/coverage.js` with the reason. `coverage.test.js` fails
+ until you do. A change to what the demo's data looks like (a module's rows,
+ or a column a page reads from them) also bumps `DEMO_VERSION` in
+ `server/src/lib/demo/index.js`, so every demo brand is rebuilt on its next
+ visit.
+
5. Push and open a pull request against `main`.
6. In your PR description, include:
diff --git a/docs/faq.mdx b/docs/faq.mdx
index 8c6432044..acc576009 100644
--- a/docs/faq.mdx
+++ b/docs/faq.mdx
@@ -57,6 +57,10 @@ description: "Common questions about Ansvisor."
For self-hosted: 100% on your infrastructure, never touches Ansvisor servers. For cloud: standard SaaS privacy — your prompts and responses are stored in our managed Supabase, isolated per organization via RLS, never used for training. Full DPA available on request for enterprise plans.
</Accordion>
+ <Accordion title="Can I try Ansvisor without a card?">
+ On Ansvisor Cloud, both ways to start a plan, buying it or the 14-day free trial, take a card. Without one, explore a demo brand with sample data from the plan step of sign-up. Your own brand stays saved, and tracking starts on it when you pick a plan. See [Demo brand](/guides/demo-brand).
+ </Accordion>
+
<Accordion title="Does Ansvisor work for non-English brands?">
Yes — 13 languages and 18 regions supported. AI engines respond in the language of the prompt; Ansvisor's mention/citation parsing is language-agnostic.
</Accordion>
diff --git a/docs/guides/demo-brand.mdx b/docs/guides/demo-brand.mdx
new file mode 100644
index 000000000..eafc162b9
--- /dev/null
+++ b/docs/guides/demo-brand.mdx
@@ -0,0 +1,57 @@
+---
+title: "Demo brand"
+description: "Explore Ansvisor on a sample brand before you pick a plan, or after yours has ended."
+---
+
+The **demo brand** is **Brewline Coffee**, a made-up coffee roaster with a month of sample data. It lets you look around the live product, page by page, before Ansvisor works on your own brand. It's an Ansvisor Cloud feature.
+
+## Who sees it
+
+- **New workspaces without a card.** Starting a plan takes a card, whichever way you start. Below the plans, the sign-up step **Choose how to start** offers **Not ready to add a card? Explore a demo brand**. Your own brand stays saved, and tracking starts on it when you pick a plan.
+- **Workspaces whose trial ended or whose plan was cancelled.** They keep their own data, read-only, and the read-only banner offers **See the demo**.
+- **Everyone in the workspace.** Once it exists, the demo brand is in the brand menu as **Demo · sample data**. There's one per workspace.
+
+## What it shows
+
+The demo brand is an ordinary brand in your own workspace, so every page reads it the way it reads yours: the same screens, filters, tabs and links. The sample data includes:
+- a dozen tracked prompts and their answers from six AI platforms;
+- the citations and mentions in those answers;
+- four competitors;
+- shopping cards, search volumes and query fan-outs.
+
+Everything in it is fictional. Brewline, its competitors and every site it's cited on live on `.example` domains, which can't belong to a real company.
+
+A band across the top says you're on the demo brand, with the way to your own brand. Chat shows as **Soon (next week)**, with a preview. **Settings → Integrations** shows Google Search Console, Google Analytics and Webflow connected with sample data, and the integrations still to come as coming soon. WordPress and Framer show as on any brand, not connected: connecting one opens the plans.
+
+## What it can't do
+
+Nothing on the demo brand runs, uses AI or costs anything:
+- it's never tracked, audited or synced, and no job or e-mail runs for it;
+- it never counts against your plan's brands or prompts.
+
+Anything that would run or use AI, such as tracking, generating, improving, auditing or sending, opens the plans instead. Each plan starts one of two ways, both with a card:
+
+| Way to start | What you get |
+|---|---|
+| **Buy now** | The full plan from day one. On a monthly plan, **50% off your first month** while the offer runs (marked **Limited offer**). |
+| **Start 14-day free trial** | The plan free for 14 days with limited AI usage, then its usual price. No discount. Only for a workspace that never had a plan. |
+
+A workspace whose trial ended or whose plan was cancelled can buy now.
+
+The demo brand can't be changed or deleted.
+
+## Hide it, show it again
+
+Admins and managers hide the demo brand from the brand menu with **Hide the demo brand**, and bring it back with **Show the demo brand**. Hiding is for the whole workspace. The demo brand is hidden when your workspace first starts a plan, and it's never deleted: it can be shown again, for a colleague who joins or after a plan ends.
+
+## How it stays current
+
+The demo brand follows the product, without anyone updating it:
+
+- It's rebuilt on the next visit when Ansvisor changes what the demo shows, or when its data is more than 3 days old. Its dates always end around today.
+- A rebuild keeps the brand and its pages' addresses, so a saved link to the demo still opens.
+- Sample data that nobody opened for 14 days is cleared, and built again on the next visit.
+
+## Self-hosting
+
+The demo brand is part of Ansvisor Cloud. A self-hosted workspace has no plan step and never turns read-only, so nothing offers it. Migration `00380_demo_brand.sql` still runs on every install: it adds the demo columns to `brands` and changes nothing for your own brands.
diff --git a/docs/mint.json b/docs/mint.json
index a8d471542..e88367aad 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -77,6 +77,7 @@
"group": "Platform Guides",
"pages": [
"guides/add-your-first-brand",
+ "guides/demo-brand",
"guides/action-center",
"guides/answer-engine-insights",
"guides/topics",