Onboarding

Skyflow

21 cards ~ 1.7 h Foundational

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

  1. skyflow beginner 5 min

    System Architecture Overview

    Use when: onboarding to skyflow service boundaries; deciding which service owns a new endpoint; tracing a request from client to data store

  2. skyflow beginner 4 min

    Tier Model & Resource Limits

    Use when: adding a new tier-gated endpoint; answering 'why did this user get 429'; pricing or upgrading a feature

  3. skyflow intermediate 5 min

    User & Subscription Schema

    Use when: writing a migration that touches user identity; debugging duplicate subscription rows; implementing GDPR delete

  4. skyflow intermediate 5 min

    Protobuf BaseEvent Envelope

    Use when: adding a new event type to a protobuf file; debugging duplicate event delivery; tracing a request across services with correlation_id

  5. skyflow intermediate 6 min

    NATS JetStream Stream Topology

    Use when: adding a new event subject; diagnosing missed events or slow consumers; sizing storage for a new tenant

  6. skyflow beginner 3 min

    Event Subject Naming Convention

    Use when: naming a brand-new event subject; writing a NATS subscription filter; reviewing a PR that introduces an event

  7. skyflow intermediate 7 min

    Timeline Analysis Saga

    Use when: tracing a slow timeline analysis; adding a new analysis algorithm; investigating missing XP after analysis

  8. skyflow intermediate 5 min

    Event-Sourced XP Ledger

    Use when: auditing a user's XP balance; designing a new XP-earning action; investigating suspicious XP spikes

  9. skyflow intermediate 5 min

    Achievement Unlock Pipeline

    Use when: adding a new achievement definition; debugging why an achievement did not unlock; writing a unit test for criteria evaluation

  10. skyflow intermediate 5 min

    Redis Sorted-Set Leaderboards

    Use when: adding a new leaderboard variant (per-tier, monthly); debugging stale rank values; estimating Redis memory for N users

  11. skyflow beginner 4 min

    Daily Streak State Machine

    Use when: answering 'why did my streak break'; implementing a streak-related achievement; rolling out a streak-freeze grant policy

  12. skyflow intermediate 6 min

    SSE Realtime Gateway Fanout

    Use when: adding a new push notification type; scaling realtime-gateway horizontally; debugging dropped SSE events

  13. skyflow intermediate 6 min

    Polar Billing Webhook Flow

    Use when: wiring a new Polar webhook event; diagnosing why a tier upgrade did not apply; writing an HMAC verification test

  14. skyflow intermediate 5 min

    DLQ Retry & Replay Pipeline

    Use when: responding to a DLQ size alert; replaying failed XP awards after a bug fix; deciding max_deliver for a new consumer

  15. skyflow intermediate 5 min

    Audience Materialized View Refresh

    Use when: adding a new landing-page stat card; diagnosing stale dashboard numbers; estimating the cost of a refresh cycle

  16. skyflow intermediate 5 min

    JWT RS256 & Tier Middleware

    Use when: implementing a tier-gated endpoint; rotating the JWT signing key; diagnosing a 401 on a valid token

  17. skyflow beginner 3 min

    Bluesky-Native Analytics

    Use when: writing the Skyflow tagline or homepage hero; explaining what Skyflow is to a Bluesky user in one sentence

  18. skyflow beginner 4 min

    Drift, Lift, Jet, Orbit — Who Each Tier Is For

    Use when: writing the pricing page or upgrade copy; deciding which tier to recommend in support replies

  19. skyflow beginner 3 min

    Four Scores, One Timeline

    Use when: writing dashboard copy, score tooltips, or share-card text; explaining what Skyflow actually measures, in plain English

  20. skyflow beginner 4 min

    Down While We Rebuild — The Honest Relaunch

    Use when: replying to 'why is the site down?' emails; writing the relaunch announcement or waitlist email

  21. skyflow beginner 4 min

    Why Not Hootsuite, Buffer, or a Twitter Tool

    Use when: responding to 'doesn't Hootsuite already do this?'; positioning Skyflow against general social analytics suites