How dineshkumarclg/financeflow works
Project type and purpose
• FinanceFlow is a full-stack, Next.js/React web application for personal and business finance management.
• It combines a rich frontend (UI pages, components) with a server side/API layer (Next.js app), a Firebase backend (Auth + Firestore + Storage), and AI-powered flows (using GenKit to orchestrate OpenAI or similar services).
File structure
• Top level:
• next.config.ts, tsconfig.json, tailwind.config.ts, postcss.config.mjs → build & toolchain configs
• apphosting.yaml, components.json → deployment metadata
• README.md → project overview
• src/app → Next.js “app router” pages & layouts (UI routes: login, signup, dashboard, journal, ledger, chat, settings, upload)
• src/components → atomic to composite React components broken out by feature (auth, dashboard, journal, ledger, chat, settings, layout, shared, ui controls)
• src/ai → server-side AI workflows (chat assistant, data extraction, parsing, tagging) invoked via GenKit
• src/lib → shared libraries for constants, utilities, Firebase initialization, data service wrappers
• src/contexts + src/hooks → client-side React context & custom hooks (auth, toast notifications, responsive behaviors)
README for additional insights
• Core features: user auth, transactional journal & ledger, dashboards with charts, AI-driven document parsing & chat
• Technology stack: Next.js, React, TypeScript, Tailwind CSS, Firebase, GenKit
Detailed capture of essential elements
• Inside the API layer, show GenKit flow handlers and Next.js server actions/api routes
• Inside the data layer, show Firestore collections (users, transactions, suggestions) and Storage bucket for documents
• Cross-cutting contexts/hooks lining the client side (AuthContext, use-toast)
• Build pipeline & config at the bottom or side: node/npm scripts, Tailwind, PostCSS, TypeScript compiler