Lyra — Link Intelligence Tool

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/abc12 or lyra.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 by slug:YYYY-MM-DD
    • config — global defaults (default Meta pixel ID, slug length, default UTM params)
  • Functions:
    • redirect.js — core redirect + pixel injection + click tracking (fire-and-forget via context.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 + analytics
    • config-get.js, config-update.js — global settings management
    • health.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