How anmolpandeyy/expense-cal works
Project type and purpose
• ExpenseCal is a single‐page, mobile‐first web application built with Next.js (React) and TypeScript.
• It has no separate backend service; all data is managed client-side via a Zustand store persisted in Local Storage.
• It delivers static assets (HTML/CSS/JS) through Next.js, with CI/CD (GitHub Actions) handling build and deploy.
File structure
• Top-level directories:
• app/ – Next.js App Router files (layout.tsx, page.tsx)
• components/ – React UI components subdivided into ui/, forms/, shared/
• lib/ – application core logic: store (Zustand), types (TypeScript interfaces), utils (helpers like CSV import/export)
• styles/ – Tailwind global CSS
• Config/build files: next.config.js, tsconfig.json, tailwind.config.js, postcss.config.js, GitHub Actions workflow (.github/workflows/deploy.yml).
README for additional insights
• Tech stack: Next.js 14, TypeScript, Tailwind CSS, Zustand (persist middleware), Shadcn/ui, react-chartjs-2 (Chart.js), Lucide React, date-fns.
• Core features: transaction CRUD, monthly summaries, charts, export/import JSON, offline Local Storage.
• No external APIs in MVP; future enhancements plan for authentication and cloud sync.