Tech Stack
A complete breakdown of every technology used in the Kinetic Email platform.
Frontend
| Technology | Purpose | Version |
|---|---|---|
| React | UI framework | 19.x |
| TypeScript | Type safety | 5.x |
| Vite | Build tool & dev server | 6.x |
| React Router | Client-side routing | v6 |
| Tailwind CSS | Utility-first CSS framework | 3.x |
| PostCSS | CSS processing | — |
Backend (Serverless)
| Technology | Purpose |
|---|---|
| Vercel Functions | Serverless API endpoints (api/ directory) |
| Node.js | Runtime for serverless functions |
Database & Auth
| Technology | Purpose |
|---|---|
| Supabase | PostgreSQL database, authentication, Row-Level Security |
| Supabase Auth | Magic link, Google OAuth, email/password |
| Supabase RPC | Server-side function calls (spend_tokens, check_token_balance, etc.) |
AI & Machine Learning
| Technology | Purpose |
|---|---|
| Anthropic Claude Sonnet | Email HTML generation (main model) |
| Anthropic Claude Haiku | Re-ranking RAG results (fast, cheap) |
| OpenAI Embeddings | Vector embeddings for RAG (text-embedding-3-small, text-embedding-3-large) |
| Pinecone | Vector database for RAG retrieval (2 indexes: 1536-dim + 3072-dim) |
Email Delivery
| Technology | Purpose |
|---|---|
| Resend | Primary email sending API |
| AWS SES | Fallback email delivery |
Real-Time
| Technology | Purpose |
|---|---|
| Convex | Real-time database for tracking pixels and interaction events |
Hosting & Infrastructure
| Technology | Purpose |
|---|---|
| Vercel | Hosting, CDN, serverless functions, analytics |
| Vercel Analytics | Page-level analytics |
| Sentry | Error tracking and monitoring |
Testing
| Technology | Purpose |
|---|---|
| Vitest | Test runner |
| happy-dom | DOM environment for tests (faster than jsdom) |
Build & Deploy
| Tool | Purpose |
|---|---|
scripts/prerender.mjs | Pre-renders static HTML for SEO |
scripts/generate-sitemap.mjs | Generates sitemap.xml at build time |
| Convex CLI | Deploys Convex functions before Vite build |
Build Pipeline
convex deploy \
--cmd 'npm run build:vite && npm run build:prerender && npm run build:sitemap'
This runs in sequence:
- Deploy Convex functions
- Build the Vite app (
dist/) - Pre-render pages into
dist/<route>/index.htmlwith SEO meta tags - Generate
dist/sitemap.xml