Onboarding

Smo1

30 cards ~ 3 h Foundational

Foundational walk through the smo1 project. Read top to bottom if you're new; no prior context assumed.

  1. smo1 beginner 5 min

    SMO1 Ecosystem Overview

    Use when: onboarding a new developer to the SMO1 codebase; explaining the architecture to a non-technical stakeholder; understanding the relationship between the six projects

  2. smo1 beginner 6 min

    Request Routing & Edge Resolution

    Use when: debugging why a slug returns 404 instead of redirecting; understanding how the edge worker decides between redirect, proxy, and landing; explaining the request path to an infrastructure engineer

  3. smo1 intermediate 6 min

    purr-api Layered Architecture

    Use when: adding a new feature to purr-api; tracing a bug through the call stack; explaining the Go project structure to a new backend engineer

  4. smo1 intermediate 8 min

    Core Data Models

    Use when: designing a new feature that touches users, links, or achievements; understanding the API response shape for the dashboard; debugging why a link shows the wrong status or score

  5. smo1 advanced 9 min

    Multi-Strategy Authentication in purr-api

    Use when: debugging 401 errors across different clients; adding a new auth mechanism to purr-api; auditing the security surface of the API

  6. smo1 advanced 7 min

    Airlock JWT Handoff & the smo1_session Cookie

    Use when: debugging login loops or session expiry; understanding how meow-web authenticates without its own user database; implementing SSO with Airlock in another project

  7. smo1 intermediate 6 min

    Edge Redirect Flow

    Use when: debugging why a slug does not redirect; understanding the edge worker's internal flow; optimising redirect latency

  8. smo1 intermediate 6 min

    Bot Detection & Visitor Deduplication

    Use when: investigating inflated click counts; adding a new bot pattern to the edge worker; understanding how unique visitors are counted

  9. smo1 intermediate 7 min

    Click Tracking Pipeline

    Use when: debugging missing or duplicate click counts; understanding how analytics data flows from edge to warehouse; explaining the async tracking design to a product manager

  10. smo1 intermediate 7 min

    Caching Strategy: What Is Actually Cached

    Use when: deciding whether a stale redirect is a cache problem; planning to turn on the edge KV cache; explaining why redirect latency depends on purr-api

  11. smo1 intermediate 7 min

    Link Protection

    Use when: implementing password-protected links; debugging why a protected link shows a prompt instead of redirecting; understanding the edge vs. API split for protection

  12. smo1 intermediate 6 min

    Rate Limiting: Edge per-IP, Origin per-Tier

    Use when: debugging 429 errors for specific users; adjusting rate limits for a new subscription tier; deciding whether a public purr-api route is protected from abuse

  13. smo1 beginner 5 min

    Gamification: Pawprintz, Treatz & Niblz

    Use when: explaining link health scores to a user; debugging why a link's pawprintz dropped suddenly; designing new gamification mechanics

  14. smo1 beginner 4 min

    XP & Level System

    Use when: designing new achievement rewards; understanding why a user is level 7 instead of level 8; explaining the progression curve to a product designer

  15. smo1 intermediate 8 min

    Billing via TOLL: Decision Accepted, Polar Still in Code

    Use when: debugging why a user's tier did not update after payment; someone asks whether smo1 bills through Polar or TOLL; touching any billing route, the Polar webhook, or users.tier

  16. smo1 intermediate 6 min

    KV Sync Service: Writes Nobody Reads

    Use when: planning to enable the Cloudflare KV edge cache; seeing 'KV sync service configured' in purr-api logs and wondering what it does; reviewing a change to link create, update or delete

  17. smo1 advanced 6 min

    Proxy Mode

    Use when: implementing a white-label short link; debugging why a proxied page shows broken assets; understanding path rewriting at the edge

  18. smo1 intermediate 8 min

    Database Architecture

    Use when: writing a migration or a production SQL check; deciding whether data belongs in Postgres, Redis or the click store; explaining which tables the TOLL switch leaves dormant

  19. smo1 intermediate 7 min

    Deployment Topology, Proxy Conflict & CI after eu-1

    Use when: finding where a smo1 component runs and how it deploys; debugging a landing page that loops or 404s through the Worker; asking why a PR shows no checks in smo1 repos

  20. smo1 beginner 3 min

    Cat Mode & Personality Mapping Layer

    Use when: adding a new UI label that needs both cat and professional versions; understanding why the dashboard uses words like 'Pawprintz'; explaining the dual-mode design to a designer

  21. smo1 beginner 3 min

    A Link Shortener with Personality, and a Score That Decays Honestly

    Use when: writing the smo1.io tagline or homepage hero; answering 'what category is smo1 in?' in one sentence

  22. smo1 beginner 3 min

    Three Audiences, One Personality

    Use when: deciding which audience a campaign or page speaks to; writing copy that has to land for more than one segment at once

  23. smo1 beginner 3 min

    Charmed, Trusting, Curious, In That Order

    Use when: drafting the homepage hero or first-time visitor flow; writing an empty state, a decay message, or an error

  24. smo1 beginner 4 min

    V1-ALPHA Ships When the Round Trip Closes in Sixty Seconds

    Use when: writing a launch post or status update for smo1 V1-ALPHA; explaining what 'live' actually means for smo1

  25. smo1 beginner 3 min

    Against the Template: Not Bit.ly, Not Crypto, Not Comic Sans

    Use when: reviewing a smo1 design comp or marketing draft for drift; explaining why smo1 looks different from other shorteners

  26. smo1 advanced 8 min

    x402 Paid Anonymous Links: One Payment Buys One Link

    Use when: working on POST /api/links or anything in internal/x402; a paid caller reports being charged without getting a link; reviewing why the x402-anon user can never be logged in as

  27. smo1 advanced 8 min

    TOLL Sell-Through: users.tier as a Cache of Entitlements

    Use when: implementing or reviewing the purr-api TOLL sell-through; reasoning about when a smo1 tier change becomes visible; a paid user was downgraded or not upgraded and you need the intended rule

  28. smo1 intermediate 6 min

    meow-web BFF: How the Dashboard Calls purr-api with a Service JWT

    Use when: a dashboard call to purr-api returns 401, 500 server_misconfigured or 502 bad_gateway; rotating SERVICE_JWT_SECRET; adding a new dashboard page that needs purr-api data

  29. smo1 intermediate 6 min

    petrova.smo1.io: Custom-Domain Links for petrova.codes Artifacts

    Use when: provisioning or debugging petrova.smo1.io links; adding another custom domain to smo1; a custom-domain link resolves to the wrong destination or 404s

  30. smo1 intermediate 7 min

    Launch Gates (gates/v1) and the Demo Tenant

    Use when: asking what still blocks smo1 from taking money; adding, discharging or re-targeting a launch gate; resetting the demo account before a support or sales call