# Pigeon

Pigeon tracks website visits and revenue attribution for JavaScript-based frontends.

Primary app: https://pigeon.nxnl.app
LLM documentation index: https://pigeon.nxnl.app/llms.txt

## Install Pigeon

Install Pigeon by adding this hosted HTML script tag to the website. This is the only public V1 install path.

```html
<script
  async
  src="https://pigeon.nxnl.app/api/track/script.js?websiteId=YOUR_WEBSITE_ID">
</script>
```

Replace `YOUR_WEBSITE_ID` with the website ID shown in the Pigeon install screen.

## What the script does

- Loads from `https://pigeon.nxnl.app/api/track/script.js`.
- Sends pageviews to Pigeon automatically.
- Detects whether the script is installed correctly.
- Helps connect website activity to revenue events.

## Useful docs

- Add a website: https://pigeon.nxnl.app/dashboard/new?step=site
- Portfolio dashboard: https://pigeon.nxnl.app/dashboard

## Agent guidance

1. Do not expose `TOSS_SECRET_KEY` in client code or chat.
2. Do not present package, framework, or no-code tools as Pigeon setup paths.
3. For website setup, install only the hosted script tag above.