Onboarding

Nestr

20 cards ~ 1.4 h Foundational

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

  1. nestr beginner 4 min

    Three-Component Architecture: Engine, Web, Perch

    Use when: onboarding a developer to the nestr monorepo; deciding which component owns a new feature; tracing a metric from emission to dashboard

  2. nestr beginner 4 min

    Pellet Data Model

    Use when: adding a new field to the pellet manifest; debugging a checksum mismatch on extract; deciding whether a workspace is frontend, backend, or polyglot

  3. nestr intermediate 5 min

    Zstd Compression Pipeline

    Use when: tuning zstd level for a slow CI pipeline; diagnosing a path traversal CVE alert on extract; explaining why two compressions of the same tree differ in bytes

  4. nestr beginner 3 min

    Cache Stats & Hit Ratio Health

    Use when: investigating a 'fair' or 'poor' status badge on the dashboard; deciding when to call /api/pellets/prune; explaining why the cache size graph plateaus at the tier limit

  5. nestr intermediate 5 min

    REST API Surface

    Use when: wiring a new client to the Engine; adding a new operation endpoint; auditing which routes require auth vs are open

  6. nestr intermediate 5 min

    JWT Auth & Per-IP Rate Limiting

    Use when: wiring an external IdP to the Engine via JWKS; tuning rate limits before a load test; debugging a 429 in production

  7. nestr intermediate 4 min

    WebSocket Event Stream

    Use when: subscribing a new client to live cache events; deciding whether to invalidate a TanStack Query cache on an event; debugging why the dashboard never refreshes after a compress

  8. nestr intermediate 6 min

    Engine Metrics Catalogue

    Use when: writing a Grafana panel against nestr_*; adding a new operation that needs a histogram; investigating a missing label in PromQL

  9. nestr intermediate 4 min

    Perch Bridge Federation

    Use when: diagnosing missing nestr_* series in the central Folio dashboard; tuning push interval to reduce egress cost; deciding whether to add a new metric upstream of the federation cut

  10. nestr intermediate 6 min

    Perch Custom Services Roster

    Use when: deciding which Perch service answers a given operator question; adding a new SLO or cost rule; wiring a deploy gate to error-budget compliance

  11. nestr beginner 4 min

    .nest.yaml Config Schema

    Use when: writing a fresh workspace config from scratch; adding a new service to an existing workspace; deciding what conflict_resolution mode is safe for sync

  12. nestr intermediate 5 min

    Web Dashboard Architecture

    Use when: adding a new dashboard route; writing a Playwright test for a new pellet flow; debugging a 401 redirect after token expiry

  13. nestr intermediate 4 min

    Service Dependency Graph & Topological Order

    Use when: adding a service that must clone after another; debugging an assemble that runs services in the wrong order; detecting a dependency cycle in CI

  14. nestr intermediate 5 min

    Kubernetes Deployment Topology

    Use when: installing Perch in a fresh cluster; writing a NetworkPolicy for the perch-system namespace; sizing AlertManager replicas for HA

  15. nestr beginner 3 min

    The Owl That Never Blinks

    Use when: writing the nestr.tools homepage hero; explaining what category nestr sits in to a non-engineer

  16. nestr beginner 3 min

    Platform Engineers, Not Everyone

    Use when: deciding whether a feature request fits the audience; writing copy for an outbound channel

  17. nestr beginner 3 min

    Three Words, Three Jobs, One Owl

    Use when: drafting any short-form copy: headline, social post, conference one-liner; deciding if a feature deserves a mention on the homepage

  18. nestr beginner 4 min

    Not a Rocketship: One Person, One Owl, In Public

    Use when: answering 'why should I trust this is still around in two years'; framing the founder story for a press or podcast intro

  19. nestr beginner 3 min

    Not a Build Orchestrator

    Use when: answering 'how is this different from Nx or Turborepo'; writing a comparison page or analyst brief

  20. nestr beginner 4 min

    Free, Pro, Enterprise, and the Lifetime Bet

    Use when: explaining the pricing page to a prospect; answering 'what happens after the lifetime deal sells out'