Technology stack

GrapeVest is a frontend-first app (PWA) with an optional managed backend (BaaS).

Frontend

• Next.js 15 (App Router) + React 19 + TypeScript,
• Tailwind CSS — styling, light/dark theme,
• Zod — validation of all input data,
• Web Crypto API — client-side end-to-end encryption,
• PWA — manifest, service worker, install on your phone,
• i18n — PL / EN.

Backend (optional) — Supabase

• PostgreSQL — stores the household's (encrypted) state,
• Supabase Auth — sign-in with a password,
• Row Level Security + security definer functions — access logic in the database.

In local mode (no Supabase configured) the app runs entirely in the browser (data in localStorage).

Tests and quality

• Vitest + Testing Library — unit and component tests,
• a full suite covering financial calculations, validation, migrations and crypto,
• CI runs automatically.

Hosting

• App: Vercel,
• Documentation (this site): Docusaurus → a static build on Vercel.