{"id":31078317,"url":"https://github.com/subhadro/financeflow","last_synced_at":"2025-09-16T08:51:21.433Z","repository":{"id":314842382,"uuid":"1056668680","full_name":"Subhadro/FinanceFlow","owner":"Subhadro","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-15T06:16:23.000Z","size":2030,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-15T06:28:46.841Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Subhadro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-14T15:11:29.000Z","updated_at":"2025-09-15T06:16:26.000Z","dependencies_parsed_at":"2025-09-15T06:28:50.322Z","dependency_job_id":"9f85e677-3d95-4dcc-b450-768a410c8faf","html_url":"https://github.com/Subhadro/FinanceFlow","commit_stats":null,"previous_names":["subhadro/financeflow"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Subhadro/FinanceFlow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhadro%2FFinanceFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhadro%2FFinanceFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhadro%2FFinanceFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhadro%2FFinanceFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Subhadro","download_url":"https://codeload.github.com/Subhadro/FinanceFlow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Subhadro%2FFinanceFlow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275391314,"owners_count":25456316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-16T02:00:10.229Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-16T08:51:20.100Z","updated_at":"2025-09-16T08:51:21.417Z","avatar_url":"https://github.com/Subhadro.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💰 FinanceFlow - AI-Powered Personal Finance Management Platform\n\n\u003cdiv align=\"center\"\u003e\n\n![FinanceFlow Logo](https://img.shields.io/badge/FinanceFlow-AI%20Finance%20Platform-blue?style=for-the-badge\u0026logo=react)\n\n**A comprehensive full-stack personal finance management platform with AI-powered insights, real-time analytics, and intelligent budget tracking.**\n\n[![Next.js](https://img.shields.io/badge/Next.js-15.5.3-black?style=flat-square\u0026logo=next.js)](https://nextjs.org/)\n[![React](https://img.shields.io/badge/React-18.3.1-blue?style=flat-square\u0026logo=react)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=flat-square\u0026logo=typescript)](https://www.typescriptlang.org/)\n[![Prisma](https://img.shields.io/badge/Prisma-6.16.1-2D3748?style=flat-square\u0026logo=prisma)](https://www.prisma.io/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4.17-38B2AC?style=flat-square\u0026logo=tailwind-css)](https://tailwindcss.com/)\n\n\u003c/div\u003e\n\n---\n\n## 🎯 Project Overview\n\n**FinanceFlow** is a modern, AI-powered personal finance management platform designed to help users take control of their financial lives. Built with cutting-edge technologies, it combines intuitive user experience with powerful backend processing to deliver real-time financial insights and automated budget management.\n\n### 🌟 Key Highlights\n\n- **🤖 AI-Powered Insights**: Leverages Google's Gemini AI for intelligent receipt scanning and financial recommendations\n- **📊 Real-time Analytics**: Dynamic dashboards with interactive charts and financial metrics\n- **�� Smart Notifications**: Automated budget alerts and financial insights via email\n- **🔐 Enterprise Security**: Built-in protection against common web vulnerabilities\n- **⚡ High Performance**: Optimized for speed with Next.js 15 and Turbopack\n- **📱 Responsive Design**: Seamless experience across all devices\n\n---\n\n## ✨ Features\n\n### 🏠 **Dashboard \u0026 Analytics**\n- **Real-time Financial Overview**: Live updates of account balances and transaction summaries\n- **Interactive Charts**: Beautiful visualizations using Recharts for spending patterns\n- **Quick Actions**: One-click access to common financial tasks\n- **Customizable Widgets**: Personalized dashboard layout\n\n### �� **Account Management**\n- **Multiple Account Types**: Support for checking, savings, and investment accounts\n- **Transaction History**: Comprehensive transaction tracking with search and filtering\n- **Account Analytics**: Detailed insights into spending patterns per account\n- **Balance Tracking**: Real-time balance updates and historical trends\n\n### 💰 **Transaction Management**\n- **Smart Categorization**: AI-powered transaction categorization\n- **Receipt Scanning**: Upload receipts for automatic transaction extraction using Gemini AI\n- **Recurring Transactions**: Set up and manage recurring payments\n- **Transaction Search**: Advanced filtering and search capabilities\n\n### 📈 **Budget \u0026 Planning**\n- **Intelligent Budgeting**: AI-suggested budget categories and limits\n- **Spending Alerts**: Real-time notifications when approaching budget limits\n- **Monthly Reports**: Comprehensive financial reports with AI-generated insights\n- **Goal Tracking**: Set and monitor financial goals\n\n### 🔐 **Security \u0026 Authentication**\n- **Secure Authentication**: Powered by Clerk for enterprise-grade security\n- **Data Protection**: Built-in security measures with Arcjet\n- **Privacy First**: Your financial data stays private and secure\n\n---\n\n## ��️ Tech Stack\n\n### **Frontend**\n- **Framework**: Next.js 15.5.3 with App Router\n- **UI Library**: React 18.3.1 with TypeScript\n- **Styling**: Tailwind CSS 3.4.17\n- **Components**: Radix UI + Shadcn/ui\n- **Charts**: Recharts for data visualization\n- **Icons**: Lucide React\n\n### **Backend \u0026 Database**\n- **Database**: PostgreSQL with Prisma ORM\n- **Authentication**: Clerk for user management\n- **API**: Next.js API Routes with Server Actions\n- **Background Jobs**: Inngest for async processing\n- **Email Service**: Resend for notifications\n\n### **AI \u0026 External Services**\n- **AI Processing**: Google Gemini AI for receipt scanning\n- **Security**: Arcjet for web application security\n- **Email**: Resend for transactional emails\n- **Deployment**: Vercel (recommended)\n\n### **Development Tools**\n- **Package Manager**: npm\n- **Code Quality**: ESLint + Prettier\n- **Database Management**: Prisma Studio\n- **Type Safety**: TypeScript throughout\n\n---\n\n## �� Quick Start\n\n### Prerequisites\n- Node.js 18+ \n- npm or yarn\n- PostgreSQL database (or use provided Docker setup)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/financeflow.git\n   cd financeflow\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env.local\n   ```\n   \n   Fill in your environment variables:\n   ```env\n   # Database\n   DATABASE_URL=\"postgresql://username:password@localhost:5432/financeflow\"\n   DIRECT_URL=\"postgresql://username:password@localhost:5432/financeflow\"\n   \n   # Authentication (Clerk)\n   NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key\n   CLERK_SECRET_KEY=your_clerk_secret_key\n   NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in\n   NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up\n   NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard\n   NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard\n   \n   # AI Services\n   GEMINI_API_KEY=your_gemini_api_key\n   \n   # Email Service\n   RESEND_API_KEY=your_resend_api_key\n   \n   # Security\n   ARCJET_KEY=your_arcjet_key\n   ```\n\n4. **Set up the database**\n   ```bash\n   npx prisma generate\n   npx prisma db push\n   ```\n\n5. **Start the development server**\n   ```bash\n   npm run dev\n   ```\n\n6. **Open your browser**\n   Navigate to [http://localhost:3000](http://localhost:3000)\n\n---\n\n## �� Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n### Dashboard Overview\n![Dashboard](https://via.placeholder.com/800x400/1e40af/ffffff?text=Dashboard+Overview)\n\n### Transaction Management\n![Transactions](https://via.placeholder.com/800x400/059669/ffffff?text=Transaction+Management)\n\n### AI Receipt Scanning\n![AI Features](https://via.placeholder.com/800x400/7c3aed/ffffff?text=AI+Receipt+Scanning)\n\n\u003c/div\u003e\n\n---\n\n## ��️ Architecture\n\n```mermaid\ngraph TB\n    A[Client - Next.js 15] --\u003e B[API Routes]\n    B --\u003e C[Prisma ORM]\n    C --\u003e D[PostgreSQL Database]\n    B --\u003e E[Clerk Authentication]\n    B --\u003e F[Inngest Background Jobs]\n    F --\u003e G[Resend Email Service]\n    B --\u003e H[Google Gemini AI]\n    B --\u003e I[Arcjet Security]\n    \n    J[User Interface] --\u003e K[React Components]\n    K --\u003e L[Tailwind CSS]\n    K --\u003e M[Radix UI]\n    K --\u003e N[Recharts]\n```\n\n---\n\n## �� API Documentation\n\n### Authentication Endpoints\n- `POST /api/auth/signin` - User sign in\n- `POST /api/auth/signup` - User registration\n- `POST /api/auth/signout` - User sign out\n\n### Transaction Endpoints\n- `GET /api/transactions` - Get user transactions\n- `POST /api/transactions` - Create new transaction\n- `PUT /api/transactions/:id` - Update transaction\n- `DELETE /api/transactions/:id` - Delete transaction\n\n### Account Endpoints\n- `GET /api/accounts` - Get user accounts\n- `POST /api/accounts` - Create new account\n- `PUT /api/accounts/:id` - Update account\n\n---\n\n\n## 📊 Performance Metrics\n\n- **Lighthouse Score**: 95+ across all categories\n- **First Contentful Paint**: \u003c 1.5s\n- **Largest Contentful Paint**: \u003c 2.5s\n- **Cumulative Layout Shift**: \u003c 0.1\n- **Time to Interactive**: \u003c 3.0s\n\n---\n\n## 👨‍💻 Author\n\n**Subhadro Samaddar**\n- GitHub: [@subhadrosamaddar](https://github.com/Subhadro)\n- LinkedIn: [Your LinkedIn](https://linkedin.com/in/subhadro-samaddar)\n- Email: subhadrosamaddar@gmail.com\n\n---\n\n## 🙏 Acknowledgments\n\n- [Next.js](https://nextjs.org/) for the amazing React framework\n- [Clerk](https://clerk.com/) for authentication services\n- [Prisma](https://www.prisma.io/) for database management\n- [Tailwind CSS](https://tailwindcss.com/) for styling\n- [Radix UI](https://www.radix-ui.com/) for accessible components\n- [Google Gemini](https://ai.google.dev/) for AI capabilities\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repository if you found it helpful!**\n\n[⬆ Back to top](#-financeflow---ai-powered-personal-finance-management-platform)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubhadro%2Ffinanceflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubhadro%2Ffinanceflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubhadro%2Ffinanceflow/lists"}