Architecture Overview
System architecture and foundational technical decisions for SavvySolve.
Architecture Overview
SavvySolve is built on a modern TypeScript stack optimized for developer experience, type safety, and deployment flexibility. This section covers the foundational architecture decisions that shape the entire platform.
Design Principles
The architecture reflects three core principles from our product requirements:
-
Friction-free entry - Users should get help immediately without creating accounts or navigating complex flows. This drives our choice of public procedures, serverless infrastructure, and edge deployment.
-
Solver efficiency - Solvers need fast, reliable tools. We chose technologies with excellent DX and minimal configuration overhead so solvers can focus on helping users, not fighting tooling.
-
Portability - We use services with standard APIs (Postgres, S3, WebSocket) so business logic remains portable. Every choice includes a documented migration path to avoid vendor lock-in.
Tech Stack
| Layer | Technology | Rationale |
|---|---|---|
| Runtime | Bun | Faster than Node.js, native TypeScript support, better DX |
| Framework | Next.js 16+ (App Router) | Modern React with SSR, deployable anywhere |
| Styling | Tailwind CSS v4 + shadcn/ui | Rapid UI development with accessible components |
| API | tRPC v11 | End-to-end type safety without code generation |
| Database | Neon + Drizzle ORM | Serverless Postgres with type-safe queries |
| Validation | Zod v4 | Runtime type safety, integrates seamlessly with tRPC |
| Auth | Clerk | Drop-in authentication with user management |
| Payments | Stripe | Checkout for users, Connect for solver payouts |
| Voice/SMS | Telnyx | SMS notifications, WebRTC calling, and bridge calls |
| Hosting | Vercel | Serverless deployment, built for Next.js |
| Real-time | Ably | Managed WebSocket for chat and signaling |
| Object Storage | Cloudflare R2 | S3-compatible storage for recordings, uploads |
Documentation
- Project Setup - Foundation configuration and tooling
- Styling System - Tailwind CSS v4 and shadcn/ui configuration