Documentation written for the person doing the work.
Clear, practical, example-driven. If something is unclear, tell us and we'll fix it. Our docs are updated with every platform release.
Quick start guide
- 1Step 1: Add the snippet2 minutes
Copy and paste one script tag into your website's <head>. Works with Next.js, Webflow, WordPress, Squarespace, and any static HTML site. The snippet is asynchronous - it won't slow down your page load.
- 2Step 2: Connect your Supabase database5 minutes
Mister Chameleon stores all behavioural data in your own Supabase database. Create a project (free tier works for getting started), run our migration script, and paste your connection string into the admin settings.
- 3Step 3: Create your first content variant5 minutes
Open Sanity Studio and navigate to your page. You'll see a 'Content variants' section next to each block. Click 'Add variant', write your alternative headline, and save. That's your first personalised version.
- 4Step 4: Write your first personalisation rule3 minutes
In the admin dashboard, go to Rules > New rule. Select your trigger (e.g. 'Intent score > 60') and your target (e.g. 'Hero - High intent variant'). Save and activate. The engine will start applying it on the next page load.
- 5Step 5: Verify it's working2 minutes
Use the Scenario Simulator (Dashboard > Simulate) to test your rule. Select a visitor profile, navigate to the page, and confirm you see the personalised variant. Check the analytics dashboard for your first session data.
Common setup questions
Which CMS platforms are supported?
Mister Chameleon works with Sanity (native), Storyblok, and Statamic out of the box. For other CMS platforms (WordPress, Contentful, etc.), you can use our API to fetch and cache variant content server-side. Full documentation in the Integrations section.
Do I need to self-host anything?
No. The Mister Chameleon platform is fully managed. The only infrastructure you provide is a Supabase database (free tier available) for storing your visitor data in your own account. Everything else - the decision engine, the admin interface, the APIs - is hosted by us.
What happens if the Mister Chameleon service is unavailable?
Your website continues to work normally. The decision engine is designed to fail gracefully: if it cannot resolve a variant decision, it serves the default content. Your site never goes down due to a personalisation service outage.
Can I use Mister Chameleon with a headless CMS?
Yes. Mister Chameleon is designed to work alongside any headless CMS. Variant content can be fetched from your CMS at build time and selected by the engine at request time - no client-side JavaScript required for the decision logic.
Something missing from the docs?
Tell us what you need. We write what our customers actually ask for.