GrowQR System Architecture

Durable Agent-centric architecture with RivetKit actors, OpenCode runtime & Git-backed memory

Frontend / BFF
Control Plane (Actors)
Runtime / Execution
Memory / Storage
Database
External Services
Frontend

◈React UI

  • Conversational interface
  • Real-time updates

◇Next.js BFF

  • Auth & session management
  • Payments webhooks
  • Actor management proxy
Vercel / OpenNext BFF Layer
🔐 Clerk Auth
💳 Stripe

⚡Actor Backend — RivetKit

Actor Runner
Actor Engine
Actor Storage
Durable control plane — manages lifecycle, routing & state
Sandboxed Runtime

▣Agent Runtime

  • Sub-agent orchestration
  • Skills loading
  • Tool execution
  • Dockerized isolation
OpenCode / Container Per-user sandbox
Git Memory

●Users Repos

  • Profile & goals
  • Quest history
  • Channel memory
  • Artifact storage
Git worktrees Source of truth

🧵Threads API

  • Session tracking
  • Message logs

🧠Memory API

  • Tracking memory
  • 3-layer memory model
🗄

PostgreSQL / AWS RDS

Account metadata · Recovery pointers · Operational indexes