Onboarding

Smo1

25 cards ~ 2.3 h Foundational

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

  1. smo1 beginner 4 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 5 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 10 min

    Multi-Strategy Authentication

    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 8 min

    Airlock JWT Handoff & Session Cookies

    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 5 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 6 min

    Multi-Layer Caching Strategy

    Use when: debugging stale link data; designing cache invalidation for a new feature; explaining why the same slug resolves differently on different devices

  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 5 min

    Tier-Based Rate Limiting

    Use when: debugging 429 errors for specific users; adjusting rate limits for a new subscription tier; understanding how Redis enforces sliding windows

  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 7 min

    Billing Architecture

    Use when: debugging why a user's tier did not update after payment; adding a new subscription plan; understanding webhook idempotency

  16. smo1 intermediate 6 min

    KV Sync Service

    Use when: debugging why a new link is not immediately resolvable at the edge; understanding the async write pattern for edge cache; designing bulk operations that affect many links

  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: designing a query that spans transactional and analytical data; troubleshooting slow analytics dashboards; explaining the three-database strategy to a DevOps engineer

  19. smo1 intermediate 5 min

    Deployment Topology & Proxy Conflict Resolution

    Use when: setting up a new environment (kitten/cat/lion); debugging why the landing page is not loading; understanding the Cloudflare → Vercel routing

  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