Gist Shortlinks MVP — Business Learnings
Context
The smo1.io link shortening stack (purr-api, zoomies-edge, meow-web) is intended to support personalized short URLs for GitHub Gists. This verification session confirmed the end-to-end flow works after fixing two blocking bugs.What works now
- Link creation — Users can create short links for any gist URL through the dashboard, with optional custom slugs (including hyphens, e.g.
my-gist-notes) - Redirect flow —
smo1.io/{slug}redirects to the destination gist via either purr-api (direct) or zoomies-edge (Cloudflare edge, sub-50ms globally) - Analytics tracking — Click tracking fires on every redirect, feeding into ClickHouse for dashboard analytics
- Edge caching — Links are cached in Cloudflare KV with 5-minute TTL for fast global resolution
Key insight
No gist-specific code was needed. The shortlink stack is URL-agnostic — gist URLs are handled the same as any other destination. The value proposition for gists is purely in the user workflow (short memorable URLs for sharing code snippets) rather than requiring special backend treatment.What was blocking
Two infrastructure bugs prevented the redirect pipeline from working end-to-end:- The edge worker couldn’t resolve slugs (missing API endpoint)
- Custom slugs with hyphens were rejected by the backend but allowed by the frontend
Next steps
- Monitor gist link creation volume in the dashboard
- Consider adding gist metadata preview (description, file count) to the link card UI
- Evaluate whether gist-specific analytics (e.g. “which gists get the most clicks”) would be valuable