Install guides
Pick the guide that matches your stack. Each page walks you through:
- The exact
npm install(or<script>tag) for that framework - Where to put the support route in your app
- How to sign visitor emails server-side so logged-in users are identified
- Common pitfalls + how to fix them
| Stack | Time | Guide |
|---|---|---|
| Next.js (App Router) | ~5 min | → Next.js guide |
| Vite + React | ~5 min | → Vite guide |
| Remix | ~10 min | → Remix guide |
| Ruby on Rails | ~10 min | → Rails guide |
| Django | ~10 min | → Django guide |
| Express + any frontend | ~10 min | → Express guide |
| Plain HTML (no build step) | ~2 min | → HTML guide |
Stack not listed? Use the generic Web SDK guide — the SDK is framework-agnostic.
Using Claude Code or another AI editor?
Skip the manual steps — install our Claude Code skill and run /lira-install in your editor. The skill detects your framework, asks for your org id, and scaffolds the setup in one command.
Something not working?
See the Troubleshooting guide — symptom-to-fix map for every common setup problem. Or open Lira dashboard → Settings → Support → Health & audit to run live diagnostics on your setup.
What you need before starting
Three things — get them from your Lira dashboard:
- Your
org_id— Settings → Organization → Org ID - Your widget secret — Settings → Support → Get connected → Widget secret (used to sign logged-in visitor emails server-side)
- Activated support module — if you haven't activated yet, the Lira widget will guide you through it first
Each per-framework guide assumes you have these in hand.