Summary
Lyra is the team's custom URL shortener and link intelligence platform. It creates trackable short links that fire ad pixels on click and log click analytics (device type, referrer, timestamp). Built on Netlify + Netlify Blobs, deployed at lyra.stoicagent.com and l.getrealstl.com. Admin dashboard at lyra-admin.netlify.app. Local folder: Tools/Lyra/site/.
What It Does
- Shortens URLs to branded short links (
l.getrealstl.com/abc12orlyra.stoicagent.com/abc12) - Fires ad pixels on every click — Meta, Google, TikTok, or custom snippets injected into a 350ms redirect page
- Tracks click analytics — click count, device type (iOS/Android/Mac/Windows), referrer source, hashed IP (privacy-preserving), timestamp
- Admin dashboard (
lyra-admin.netlify.app) to create, manage, and analyze links
Architecture
- Platform: Netlify (serverless ESM v2 functions, Netlify Blobs storage, Sentry error tracking)
- Data stores (Blobs):
links— link records (slug, destination, pixels, click count, timestamps, notes)clicks— daily click event logs keyed byslug:YYYY-MM-DDconfig— global defaults (default Meta pixel ID, slug length, default UTM params)
- Functions:
redirect.js— core redirect + pixel injection + click tracking (fire-and-forget viacontext.waitUntil)links-create.js— create new link (auto-slug or custom slug)links-list.js,links-update.js,links-delete.js,links-stats.js— CRUD + analyticsconfig-get.js,config-update.js— global settings managementhealth.js— health check endpoint
Default Configuration
- Default Meta pixel:
139286293549346(team pixel) - Slug length: 5 characters (auto-generated from
[a-z0-9]) - Reserved slugs that cannot be used:
_health,api,admin,favicon.ico
Status (2026-04-17)
Ready for deployment. Both a standalone link management tool AND a pipeline component auto-invoked by spark-showcase-builder.
Use Cases
- Auto-baked into Spark landing pages — Every showcase page built by spark-showcase-builder gets a LyraLink short URL generated automatically with Meta pixel injection. No manual step required.
- Listing marketing — Short links in social posts, ads, and emails with pixel firing for retargeting
- Showcase/CMA links — Track who clicked seller reports
- Ad campaigns — All Meta/Google ads route through Lyra to capture pixel events even on external destinations
- QR codes — Branded short URLs for print materials (business cards, sign riders). Killer feature: the destination can change without changing the QR code itself. Print a sign with a Lyra QR → later re-point it from a listing page to a "just sold" page without reprinting.
- Performance tracking — Know which channels (direct, Instagram, Facebook, email) are actually driving clicks
Positioning vs. Geniuslink
"Same service as Geniuslink, but it's better, and it's for us."
Advantages over Geniuslink:
- Free to agents (vs. Geniuslink paid tier)
- Injects Meta pixel + Google Ads conversion ID + TikTok pixel + custom snippets (Geniuslink does not)
- Destination-editable without re-printing QR codes
- Owned infrastructure — no vendor risk
Privacy
IP addresses are one-way hashed before storage (non-reversible djb2 hash → base36). Raw IPs are never stored.
Related
- tool-build-sop — Build standards this tool follows (v2 functions, CORS, Sentry, Blobs)
- spark-showcase-builder — Primary consumer — every Spark page auto-generates a LyraLink
- hermes-social-command — Lyra links are distributed via Hermes posts
- listing-marketing-engine — Primary use case for Lyra links
- marketing-stack-migration — Lyra is part of the owned marketing stack replacing Curaytor and Geniuslink