Introduction

Bluestars adds a motivation-driven personalization layer to your existing website. You install one script, and from your Bluestars dashboard you can:

Personalize by BSR segment — every visitor is matched to a Market Response motivation segment (based on their region). The widget exposes that segment to your site so copy, imagery, and calls-to-action can adapt to why a visitor is there, not just who they are.
Run the AI assistant — an on-page conversational assistant that knows your website and products, greets visitors in a segment-appropriate tone, and helps them decide and convert.

How the pieces fit together

Everything is driven by one embed script plus your dashboard configuration. There is nothing to build into your templates beyond the script tag.

Capability	What you do	Where it’s documented
Install	Add one `<script>` tag with your tenant ID	Installation
Segment class	Style against the `bsr-segment-*` class we add to `<body>`	The segment class
Content swapping	Point CSS selectors at existing text; we rewrite it per segment	Content swapping
Assistant	Configure placements, theme, and behavior in the dashboard	The assistant
Go live safely	Preview with `?bs=1`, then publish	Test vs. Live

The two personalization mechanisms

There are two distinct ways to personalize, and it’s worth knowing the difference:

The segment class — we add a bsr-segment-<slug> class to <body>. You write your own CSS against it. Pure front-end, no content managed by us.
Content swapping — you mark existing elements with a CSS selector in the dashboard, and we rewrite their text per segment (served from a cache).

Use the class for styling and layout; use content swapping for wording.

Where to configure

Your dashboard lives at https://bluestars.app/tenant/<your-tenant>. New tenants start in test mode — nothing is shown to real visitors until you set it live and publish. Start with Installation, then Test vs. Live.