Expense Hero

A full-stack expense tracking application built with Next.js, featuring AI-powered receipt scanning, budget management, and financial insights.

Features

• 📊 Dashboard Overview - Track your financial health at a glance
• 💳 Multi-Account Support - Manage multiple bank accounts and credit cards
• 📱 Receipt Scanning - AI-powered receipt scanning for automatic transaction entry
• 📈 Budget Management - Set and track budgets with intelligent recommendations
• 🔄 Recurring Transactions - Automate recurring income and expenses
• 📊 Analytics - Detailed spending insights and trends
• 🔐 Secure Authentication - Powered by Clerk for secure user management

Tech Stack

• Frontend: Next.js 15, React 19, TypeScript
• Styling: Tailwind CSS, Radix UI
• Database: Prisma with PostgreSQL
• Authentication: Clerk
• AI: Google Gemini for receipt scanning
• Security: Arcjet for rate limiting and protection

Getting Started

1. Clone the repository
2. Install dependencies: npm install
3. Set up environment variables (see .env.example)
4. Run database migrations: npm run db:migrate
5. Start the development server: npm run dev

Environment Variables

Copy .env.example to .env.local and fill in the required values:

• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY
• CLERK_SECRET_KEY
• DATABASE_URL
• GEMINI_API_KEY
• ARCJET_KEY

Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run db:migrate - Run database migrations
• npm run db:studio - Open Prisma Studio
• npm run lint - Run ESLint