Your AI-Powered Financial Co-Pilot — Track expenses, optimize taxes, grow investments, and achieve financial goals with an intelligent AI advisor that understands your money.
70% of young adults lack adequate financial literacy tools. Traditional finance apps are either too complex for beginners or too simple for serious financial planning. There's a massive gap between personal spreadsheets and expensive financial advisors.
Key challenges:
- People don't know where their money is going each month
- Tax deductions are routinely missed, costing hundreds annually
- Investment portfolios lack proper diversification analysis
- Financial goals exist only as vague intentions, not actionable plans
FinPulse AI is an all-in-one personal finance intelligence platform that combines real-time data visualization with AI-powered insights to give users a complete picture of their financial health.
Unlike traditional finance apps, FinPulse AI features a conversational AI advisor (powered by Google Gemini) that analyzes your complete financial context — spending patterns, investment portfolio, tax situation, and goals — to deliver personalized, actionable recommendations.
| Feature | Description |
|---|---|
| 📊 Smart Dashboard | KPI cards with animated counters, spending doughnut chart, cash flow trends, budget health bars, and rotating AI insights |
| 🤖 AI Financial Advisor | Chat interface powered by Gemini AI with context-aware responses, quick prompts, typing animation, and markdown rendering |
| 💳 Expense Intelligence | Automatic categorization, horizontal bar chart breakdown, anomaly detection for unusual spending, and category filters |
| 📈 Investment Portfolio | Allocation pie chart, AI health score (0-100), individual holdings with mini sparklines, and buy/hold/sell signals |
| 🧾 Tax Optimizer | Deduction finder based on expense data, tax bracket visualization, AI tips carousel, and filing document checklist |
| 🎯 Financial Goals | Progress rings, AI-generated savings strategies, milestone tracking, and monthly contribution calculators |
| ⚙️ Settings | Profile management, notification preferences with toggle switches, connected accounts, data export, theme preferences |
- 🌐 Marketing Landing Page — Hero with animated gradient orbs, features grid, pricing tiers, testimonials carousel
- 🧙 4-Step Onboarding Wizard — Personalized setup with confetti celebration
- 🔔 Notification Center — AI-generated financial alerts
- 🍞 Breadcrumb Navigation — Context-aware header with breadcrumbs
- 📱 Mobile Bottom Tab Navigation — Fully responsive with mobile-optimized layout
- ✨ Toast Notifications — Success/error/info notifications with auto-dismiss
- 🎨 Glassmorphism Design System — 40+ design tokens, 15+ animations
| Technology | Purpose |
|---|---|
| React 18 | Frontend UI framework |
| Vite 6 | Build tool and dev server |
| Chart.js + react-chartjs-2 | Data visualization (Doughnut, Line, Bar, Pie charts) |
| Google Gemini AI | AI-powered financial advisor (with free API) |
| Lucide React | Icon library |
| Vanilla CSS | Custom design system with CSS variables |
| Inter + Space Grotesk | Typography (Google Fonts) |
- Node.js 18+
- npm or yarn
# Clone the repository
git clone https://github.com/yourusername/finpulse-ai.git
# Install dependencies
npm install
# Start development server
npm run devThe app will be available at http://localhost:5173
To enable live AI responses, create a .env file:
VITE_GEMINI_API_KEY=your_gemini_api_key_hereWithout an API key, the app uses intelligent demo responses that showcase the AI's capabilities.
Get a free Gemini API key at Google AI Studio.
src/
├── components/
│ ├── Layout/ # AppShell (sidebar, header, mobile nav)
│ └── ui/ # Design system (Button, Card, Modal, Toast, etc.)
├── context/ # Global state management (React Context + useReducer)
├── data/ # Mock financial data (6 months of realistic data)
├── pages/ # All page components
│ ├── LandingPage # Marketing homepage
│ ├── Onboarding # 4-step setup wizard
│ ├── Dashboard # Main financial dashboard
│ ├── AIChat # AI advisor chat interface
│ ├── Expenses # Expense tracking & analysis
│ ├── Investments # Portfolio tracker
│ ├── TaxOptimizer # Tax deduction finder
│ ├── Goals # Financial goal planner
│ └── Settings # App preferences
└── services/ # Gemini AI integration
This project is submitted under:
- 🤖 Best AI Project — Gemini-powered financial advisor with context-aware insights
- 💰 Best Fintech Project — Complete personal finance management platform
- 🛠 Best Software Development Solution — Production-grade architecture with reusable design system
- 📊 Data Science & Business Analytics — Financial data visualization and insight generation
- Real bank account integration (Plaid API)
- OCR receipt scanning
- Multi-currency support with live exchange rates
- Collaborative family budgeting
- Mobile app (React Native)
- Dark/Light theme toggle
- PDF financial report generation
- Webhook notifications (Slack, Discord, Email)
Vivek — Full Stack Developer
This project is licensed under the MIT License.
Built with ❤️ for Dev Season of Code 2026