3 weeks of building in public — here's everything I learned shipping a product tour SDK from scratch
I'm a solo developer and I've been building TourKit for the past 3 weeks. Here's an honest breakdown of what I built, what broke, what I learned, and whether I should launch on Product Hunt.
What I built:
TourKit — a lightweight product tour SDK. One script tag, dashboard-controlled tours, works on any stack.
The core idea: most onboarding tour tools are either too expensive, too heavy, or require installing a library. I wanted something you could drop into any website in 5 minutes.
Stack I used:
- Next.js (App Router) — dashboard + docs + landing page
- Supabase — auth, database, row level security
- Vanilla JS SDK — no framework dependency, bundled with esbuild
- Vercel — hosting and deployments
- Anthropic API (Claude) — AI tour generator for Pro users
---
Biggest bugs I hit and fixed:
React 18 StrictMode double injection — SDK was loading twice causing overlapping tooltips. Fixed with an ID guard on the script tag.
localStorage seen flag — completing a tour on / was blocking tours on /dashboard. Fixed by making seen flags path-scoped (tourkit_seen_KEY_dashboard instead of tourkit_seen_KEY).
Client-side navigation — Next.js and React change URLs without reloading. SDK wasn't detecting this. Fixed by exposing a window.TourKit global API and calling TourKit.startFor(pathname) on route change.
Demo mode — needed tours to replay on every page in the sandbox without affecting real user seen flags. Fixed with a demo flag that skips localStorage writes entirely.
---
What I shipped:
- One script tag SDK (HTML, React, Next.js, Vue compatible)
- Dashboard to build and manage tours without redeploying
- URL-based tour triggers (context-aware tours per page)
- Analytics — starts, completions, skips, step drop-off
- Multi-page demo sandbox for testing
- AI tour step generator (Pro feature, powered by Claude)
---
Current status:
- Fully working and tested across React, Next.js, plain HTML
- Free plan: 1 project, basic analytics
- Pro plan: $19/month — unlimited projects + AI generator
- Live at: tourkit-phi.vercel.app
---
My honest questions:
What's missing that would make you actually use this?
Is $19/month reasonable or too high for a solo-built tool?
Should I launch on Product Hunt now or keep building?
Happy to share more about any part of the build. This community has been super helpful watching others build — figured it was time to share my own journey. 🙏