Empowering Gen Z with Smart Finance - One Pixel at a Time
Finfluenzz is a cutting-edge fintech application designed specifically for Gen Z users, combining financial management with a retro gaming aesthetic. Our platform makes finance fun, accessible, and engaging through gamification, AI-powered insights, and modern UX design.
🔗 Live Application: https://finfluenzz.vercel.app/
🔗 Demo Link: https://www.youtube.com/watch?v=tmsRVF5pLj8
To democratize financial literacy and empower the next generation with smart money management tools wrapped in an engaging, game-like experience.
- Smart Investment Recommendations powered by Groq AI (Fed with real time stock/crypto data)
- Real-time Stock Analysis using Alpha Vantage APIs
- Dual Chart Modes for Stocks - Switch between candlestick patterns and 50-day trend analysis (stocks only)
- Real-time Candlestick Charts - Intraday minute-level data with pattern detection for stocks
- Advanced Pattern Detection - Identifies 15+ candlestick patterns (Doji, Spinning Top, Hammer, Engulfing, etc.)
- Pattern Toggle Control - Show/hide pattern symbols for clean chart analysis
- Interactive Pattern Details - Click patterns for detailed explanations and confidence scores
- Crypto Chart Support - Traditional price charts for cryptocurrency analysis (line charts only)
- Personalized Financial Advice based on user profile and goals
- Enhanced Technical Indicators including RSI, SMA20, SMA50, MACD calculations
- Risk Assessment and confidence scoring for investment decisions
- Market Status Tracking - Real-time US and Indian market hours monitoring
- AI Portfolio Analysis - Powered by Gemini API for comprehensive portfolio insights
- Current Holdings Analysis - Detailed breakdown of your investment positions
- Portfolio Performance Metrics - Risk assessment, diversification analysis, and recommendations
- Smart Investment Insights - AI-driven suggestions based on your current holdings
- Portfolio Health Score - Overall portfolio evaluation with actionable advice
- Asset Allocation Analysis - Sector and geographic diversification insights
- Risk-Return Optimization - Personalized recommendations for portfolio improvement
- Multi-source News Integration - Finnhub API for comprehensive market coverage
- Stock-specific News - Company news filtered by symbol
- Crypto News Coverage - Dedicated cryptocurrency news section
- Real-time News Feed - Latest financial headlines with timestamps
- Real-time Expense Management with CRUD operations
- Smart Categorization of expenses and income
- Smart AI Summarizer about Weekly/Monthly expenditure
- Personalized Financial Challenges based on spending patterns
- Achievement System with progress tracking, Gamified Dynamic Leveling up system
- Gamified Challenges Experience gain and leveling up gamified experience on completing challenges
- Weekly/Monthly Goals for savings and budgeting
- JWT-based Authentication with refresh tokens
- Protected Routes and role-based access
- Password Encryption using bcrypt
- Session Management with automatic logout
- Enhanced User Caching - Improved session persistence
- Pixel-perfect Design inspired by classic arcade games
- Enhanced Mobile Optimization - Responsive charts and controls
- Pattern Reference Tables - Educational candlestick pattern guides
- Responsive Layout for all devices
- Smooth Animations and micro-interactions
- Accessibility Features for inclusive design
- React 18 - Modern UI library with hooks
- TypeScript - Type-safe JavaScript development
- Vite - Fast build tool and dev server
- Tailwind CSS - Utility-first CSS framework
- Lightweight Charts - Professional trading chart library for candlestick visualization
- Axios - HTTP client for API requests
- React Router - Client-side routing
- Lucide React - Beautiful icon library
- Cloudflare Workers - Serverless edge computing
- Hono Framework - Lightweight web framework
- Prisma ORM - Type-safe database access
- Neon PostgreSQL - Serverless database
- JWT - Secure authentication tokens
- bcrypt - Password hashing
- Groq AI - Advanced language model for financial advice in Finance Advisor
- Gemini AI - Portfolio analysis and investment insights in Investment Zone
- Alpha Vantage API - Primary real-time stock data provider with intraday support
- Finnhub API - News integration and backup stock data
- CoinGecko API - Cryptocurrency data and historical pricing
- Vercel - Frontend deployment and hosting
- Node.js 18+
- npm or yarn
- Git
-
Clone the repository
git clone https://github.com/your-username/finfluenzz.git cd finfluenzz -
Install frontend dependencies
npm install
-
Install backend dependencies
cd Finfluenzz/backend npm install -
Environment Setup
Frontend (Create
.envfile in root):# Required for stock market data and real-time charts VITE_ALPHA_VANTAGE_API_KEY="your-alpha-vantage-key" # Required for financial news terminal VITE_FINNHUB_API_KEY="your-finnhub-api-key" # Required for AI financial advisor VITE_GROQ_API_KEY="your-groq-api-key" # Optional: For enhanced portfolio analysis VITE_GEMINI_API_KEY="your-gemini-api-key"
Backend (Environmental Variables):
DATABASE_URL="your-neon-postgresql-url" JWT_SECRET="your-jwt-secret-key"
- Visit Alpha Vantage
- Sign up for free API key (500 requests/day)
- Add
VITE_ALPHA_VANTAGE_API_KEYto your.envfile
- Visit Finnhub
- Create free account (60 API calls/minute)
- Add
VITE_FINNHUB_API_KEYto your.envfile
- Visit Groq Console
- Create account and generate API key
- Add
VITE_GROQ_API_KEYto your.envfile
-
Visit Google AI Studio
-
Create account and generate API key
-
Add
VITE_GEMINI_API_KEYto your.envfile -
Database Setup
cd backend npx prisma migrate dev npx prisma generate -
Start Development Servers
Frontend:
npm run dev
Backend (if running locally):
cd backend npm run dev -
Open Application Navigate to
http://localhost:5173in your browser
- Sign Up - Create your account with basic financial information
- Complete Profile - Set your financial goals and preferences
- Explore Dashboard - Navigate through different features using the sidebar
- Start Budgeting - Add your first expenses and set budget goals
- ** Analyze Individual Assets** - Use Finance Advisor for real-time stock/crypto analysis with candlestick charts
- ** Analyze Your Portfolio** - Use Investment Zone for comprehensive portfolio analysis via Gemini AI
- ** Read Market News** - Stay updated with Finnhub news terminal
- Get AI Advice - Chat with our finance advisor for personalized recommendations
- Take Challenges - Complete gamified tasks to improve your financial habits
POST /api/signup- User registrationPOST /api/signin- User loginGET /api/me- Get current user profile
GET /api/expense/all- Get all user expensesPOST /api/expense/add- Add new expenseDELETE /api/expense/delete/:id- Delete expense
- Levels based on financial knowledge (Beginner → Player → Pro)
- Progress Bars showing completion of financial goals
- Achievement Badges for completing challenges
- XP System for consistent app usage
- Retro Pixel Art aesthetic throughout the application
- 8-bit Color Palette with blue (#007FFF) and navy (#001F3F) themes
- Arcade-style Buttons with hover effects and animations
- Interactive Charts with gaming-inspired UI elements
- Pixelated Backgrounds and floating elements
- JWT Authentication with secure token storage
- Password Hashing using industry-standard bcrypt
- Route Protection preventing unauthorized access
- Input Validation and sanitization
- CORS Configuration for secure API access
- Environment Variables for sensitive data protection
The application is deployed on Vercel with automatic builds from the main branch.
Live URL: https://finfluenzz.vercel.app/
The API is deployed on Cloudflare Workers for global edge distribution and optimal performance.
Ensure these are configured in your deployment:
VITE_ALPHA_VANTAGE_API_KEY="production-alpha-vantage-key"
VITE_FINNHUB_API_KEY="production-finnhub-key"
VITE_GROQ_API_KEY="production-groq-key"
VITE_GEMINI_API_KEY="production-gemini-key"We welcome contributions! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Made with 💙 for Gen Z by Laksh
Empowering the next generation to take control of their financial future, one pixel at a time.