# NoteLett — Deep links for agents and humans

**Product id:** `notelett` (see `shared/product.json`).

## Web URLs

| Purpose | Pattern | Example |
|--------|---------|---------|
| Note (authenticated) | `{origin}/notes/{noteId}` | `https://app.example.com/notes/abc-123` |
| Search with query | `{origin}/search?q={query}` | `https://app.example.com/search?q=draft` |
| Reviews | `{origin}/reviews` | |
| Workspace chat | `{origin}/chat` | |
| Read-only share | `{origin}/share/{shareToken}` | After **Copy share link** on a note |

Set `NEXT_PUBLIC_WEB_APP_ORIGIN` in production so copied share links use the public hostname when SSR runs.

## Custom URL scheme (optional)

For desktop or mobile handlers you can register `notelett://note/{noteId}` with the OS; the web app currently uses HTTPS routes as the source of truth.

## API bases

- **Notes backend:** `NEXT_PUBLIC_NOTES_API_URL` (e.g. `https://api.example.com/api`)
- **Public share JSON:** `GET {NOTES_API_URL}/public/note-shares/{token}` (no auth)