# Hitsteps for Lovable

> Hitsteps is hosted website analytics for live visitor insight. This page is a
> machine-readable install guide for AI builders adding Hitsteps to an app built
> with Lovable.

Canonical site: https://www.hitsteps.com/

Live install kit. English machine-readable guide, updated 2026-11-16.
The public install page is https://www.hitsteps.com/lovable/.
Compatibility notes below describe one bounded private test.

## Install in one step

Add this script tag to the app's shared Layout component (the layout that wraps
every page), exactly once:

```html
<script async src="https://edgecdnplus.com/code?code=YOUR_SITE_CODE&spa=1"></script>
```

Requirements:

- Before you paste: open the Hitsteps dashboard, go to the site Settings page, and
  set the site's consent mode to match the notice your app will show. Configure
  and check the consent choice before you drive traffic to the app.
- Replace YOUR_SITE_CODE with the site's 32-character hexadecimal Hitsteps code
  (0-9 and a-f) from the dashboard tracking settings. Do not append the dashboard
  API suffix or anything else to the code value.
- Keep the tag in the shared Layout so every existing and future page loads it,
  including new pages and later redesigns.
- The tag must appear exactly once per page. Do not duplicate it.
- `spa=1` enables page-change tracking for client-side navigation and must be
  kept in the URL.
- If the app defines a Content-Security-Policy, allow https://edgecdnplus.com
  in script-src, img-src and connect-src.

## Verify the install

- Open the app once in a normal browser after the tag is added.
- In the Hitsteps dashboard the site should show as tracking, and its first
  visit should appear within a few minutes.

## Compatibility

Tested on one private, unpublished Lovable app on 2026-11-16 (a single bounded
sample, not a reliability rate):

- Current Lovable apps (TanStack Start) change pages with the History API; the
  tag counted each page change, including Back, in that private test. One paste
  installed the tag once in the shared Layout, and the tag survived a redesign
  that added a new page.
- Older React + Vite Lovable apps were not tested.
- A published `*.lovable.app` deployment was not tested; the test ran on the
  editor's private preview URL.
- The Content-Security-Policy case was not tested on a Lovable app. Keep the
  instruction above and never add 'unsafe-eval'.
- Consent prompt behavior inside a Lovable app was not tested.
- No guarantee is made that every Lovable framework or future framework works.

## What Hitsteps provides

- Live visitor monitoring and page-by-page journeys
- Traffic sources, referrers, campaigns and AI-referral tracking
- Click heatmaps (Growth plan and above)
- Website live chat, uptime monitoring, funnels and ecommerce analytics
  (plan-dependent)

## Consent and privacy

- The tracker uses first-party cookies. The app owner is the data controller
  for the app and remains responsible for the notice, consent choices, and
  legal basis that apply to their situation.
- In the Hitsteps dashboard, the site's consent mode (settings page) has four
  choices: always ask for full tracking; ask only when identifying information
  is being sent; track identifiable information with no popup; or track only
  non-identifiable information with no popup.
  Declining disables deeper identifying-data collection, including user-ID
  enrichment and typed form values. Core page views, visitor continuity and
  presence pings continue; this is not a cookie-free mode.
- Install prerequisite for owners: before pasting the prompt, open the Hitsteps
  site settings, set the consent mode, add a cookie notice or banner on the
  app where their law requires one, and verify one real incognito visit shows
  the intended message. No automatic consent workaround is provided and no
  storage or compliance promise is made.
- The install does not change the site's consent mode or make the owner's
  consent decisions. The kit is published with the existing consent settings
  preserved.

## Previews and your own visits

- Lovable's editor preview and its own page checks load your app, so they show
  up as visits (preview URLs on id-preview--…lovable.app). Separate your own
  previews from genuine external referrals.
- Use the site's Settings controls to exclude your browser or work IP. These
  controls were not tested inside Lovable's preview, so preview views may
  still appear. Excluding your browser does not exclude other visitors.

## Notes

- Hitsteps focuses on live visitor analytics: visitors right now, their
  journeys, traffic sources, heatmaps, uptime monitoring, funnels and chat,
  with plan limits on the features page.
- The tracker stores first-party cookies. Cookie consent and compliance stay
  the responsibility of the app owner, who is the data controller.
- Hitsteps is not affiliated with or endorsed by Lovable. Nothing here relies
  on non-public behaviour of Lovable.
