Documentation

Install, teach, map, publish.

The v1 operating guide for a Framer site owner.

1. Install from Framer

Open Site Pet in a published Framer project, connect your account, then choose Add to this site. The plugin reads the project and production publish information and installs one Body End Custom Code entry.

<script defer src="https://cdn.palbots.ai/loader/v1.js" data-site-key="sp_live_xxx"></script>

The site key is public and origin-bound. Model, billing, email and signing secrets never enter the plugin or Widget.

2. Sync knowledge

Site Pet reads the production sitemap, stays on the published origin, honors robots and noindex, removes hidden or repeated chrome, and indexes only the plan page limit. Run Sync now after important copy changes.

3. Verify frequent answers

In Dashboard → Knowledge, add an exact visitor question, optional alternatives, an approved answer, its indexed source page, and one supporting passage copied from that page. Matching questions receive the approved answer immediately with a citation and do not call the model.

Matching is exact after punctuation and case normalization. If the source page changes, the answer becomes stale and stops matching until you review and verify it again.

4. Map actions safely

Open the published-site configurator from Dashboard → Actions. Select a semantic heading, region, link, button or tab. Scroll and highlight may run automatically; navigation, disclosures and approved external links require visitor confirmation.

Forms, inputs, contenteditable regions, submit buttons, purchases and destructive controls cannot be mapped.

5. Verify and publish

Ask one factual question, open its citation, and test each mapped action on desktop and mobile. If Framer Custom Code is disabled, enable it yourself and use Repair loader; the plugin never silently re-enables it.

6. Turnstile and strict CSP

Site Pet loads Turnstile only after suspicious chat traffic reaches the server-side rate limit. A strict Content Security Policy must allow https://challenges.cloudflare.com in both script-src and frame-src; Site Pet never weakens your policy automatically.

Framer-hosted domains are covered by the managed launch configuration. A custom root domain must be provisioned before challenge-gated answers are enabled for it. Until Site Pet confirms that assignment, rate-limited traffic fails closed instead of bypassing the challenge.

Limits

A conversation is one visitor session within 30 minutes, counted at the first successful model output, with at most ten visitor messages. Site Pet has no overage billing: AI answers pause at the monthly limit.