How bankoledo/finance-flow works
Project type and purpose
• This is a full-stack, single-page application for personal finance management.
• Frontend: React 18 + Vite + Tailwind CSS, deployed on Vercel.
• Backend: Supabase as BaaS (Auth, PostgreSQL database, real-time subscriptions, RLS policies).
File structure
• Top-level:
• public/ (static assets)
• src/ (application code)
• scripts/setup-db.js (initial database schema)
• config files (vite.config.js, tailwind.config.js, postcss.config.js, eslint.config.js)
• src/ subdivided into:
• components/ (UI, layout, landing, analytics, settings, transactions)
• contexts/ (AuthContext)
• hooks/ (useDataManager)
• lib/ (supabase client wrapper)
• pages/ (public vs protected “app” pages)
• main.jsx / App.jsx (entry points)
README insights
• Tech stack and feature list.
• Supabase SQL schema with RLS.
• Supabase Authentication + Brevo for email.
• Deployment on Vercel.
a. Main components
1. Client Browser (React SPA)
2. Vercel CDN / Hosting
3. Supabase Auth (Auth UI + JWT)
4. Supabase PostgreSQL Database (tables: profiles, categories, transactions, budgets)
5. Supabase Real-time (subscriptions for live data updates)
6. Brevo Email Service (for email verification & notifications)
7. Optional: local development (Vite dev server)
b. Relationships & interactions
• Browser ↔ Vercel: HTTP(S) requests to fetch static assets.
• Browser ↔ Supabase Auth: signup, login, token exchange via supabase-js.
• Browser ↔ Supabase DB: authenticated REST and real-time GraphQL/WS calls.
• Supabase DB ↔ RLS policies enforce per-user data access.
• Browser → Brevo via serverless function or Supabase Edge Functions (for sending emails).
c. Architectural patterns
• SPA architecture with client-side routing (React Router).
• Component-driven design (atomic UI in components/ui, layout wrappers).
• Context API for global auth state.
• Hook abstraction (useDataManager) for API calls.
• BaaS pattern: no custom backend servers.
d. Key technologies
• React+Vite (front-end), Tailwind CSS, Framer Motion, Lucide.
• supabase-js SDK for Auth & Database.
• PostgreSQL with RLS on Supabase.
• Brevo for email.
• Vercel for hosting & CI/CD.