Kuber is a full-stack, enterprise-grade AI Finance Platform designed to help users track, analyze, and optimize their financial health in real time. Featuring glassmorphism design elements, multi-currency support, dynamic dark mode, an AI-powered receipt scanner, robust rate-limiting security shields, and background automation loops, Kuber transforms standard expense tracking into an intelligent personal asset management experience.
- Modern Dark/Light Theme: A premium, high-fidelity UI with dark mode support using Tailwind CSS and
next-themes. - Dynamic Multi-Currency Selector: Seamlessly switch between major global currencies (
USD,EUR,GBP,INR,JPY,CAD,AUD) with instant real-time UI formatting across all dashboards, transactions, and account balances. - Typographic Animations: Zero-asset custom CSS text effects (
animate-logo-fade) inside a clean glassmorphic header, eliminating image caching locks and enhancing First Contentful Paint (FCP). - Responsive Layout Grid: A fluid layout grid wrapper using Tailwind breakpoints designed to transition smoothly from mobile devices to wide desktop displays.
- Optimistic & Fast Mutations: Instant visual state updates via React 19 server actions, optimized Zod validation schemas, and database query optimizations.
- Smart Receipt Scanner: Upload receipt images directly to have Google Gemini parse line items, suggest semantic categories, structure timestamps, and calculate totals automatically.
- Monthly Financial Insights: Automated background evaluation pipelines that analyze spending patterns and generate actionable financial guidance.
- Authentication & Authorization: Complete user authentication powered by Clerk Auth.
- Transactional Rate Limiting & Bot Defense: Advanced token-bucket controllers and bot detection layers powered by Arcjet, keeping API networks safe from automated attacks.
- Automated Cron Scheduling: Scheduled background operations monitoring operational metrics, managing budgets, and distributing monthly email digests natively via Resend.
- Throttled Event Loops: Sophisticated event batching controls restricting execution queues to keep multi-user processes stable.
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router, Turbopack) |
| UI Components | React 19, Tailwind CSS, Shadcn UI, Lucide Icons, Framer Motion / React Spinners |
| Authentication | Clerk Auth Engine (Configured for Next.js App Router) |
| Database & ORM | Supabase (PostgreSQL), Prisma ORM |
| AI Processing | Google Generative AI (Gemini 3.1 Flash / 1.5 Flash Models) |
| Security & Middleware | Arcjet Security Shield (Rate Limiting, Bot Detection) |
| Event Pipelines | Inngest Event Engine |
| Email Service | Resend API + React Email |
| Data Visualization | Recharts (Responsive Vector Area & Bar Graphs) |
Ensure your machine has Node.js (v18+) installed, then follow these setup steps:
git clone https://github.com/Mr-Prince2/Kuber.git
cd KuberCreate a .env file in the root directory and supply your environment credentials:
# Supabase PostgreSQL Connection
DATABASE_URL="postgresql://postgres:YOUR_PASSWORD@db.YOUR_PROJECT.supabase.co:5432/postgres?sslmode=require"
DIRECT_URL="postgresql://postgres:YOUR_PASSWORD@db.YOUR_PROJECT.supabase.co:5432/postgres?sslmode=require"
# Clerk Authentication Settings
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/dashboard
NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/dashboard
NEXT_PUBLIC_CLERK_SIGN_IN_FORCE_REDIRECT_URL=/dashboard
NEXT_PUBLIC_CLERK_SIGN_UP_FORCE_REDIRECT_URL=/dashboard
# Third Party API Services
GEMINI_API_KEY=AIzaSy...
ARCJET_KEY=ajkey_...
RESEND_API_KEY=re_...
INNGEST_DEV=1npm install --legacy-peer-depsnpx prisma generate
npx prisma db pushnpm run devOpen http://localhost:3000 in your browser.
In a separate terminal, launch the local Inngest dev server:
npx inngest-cli@latest dev -u http://localhost:3000/api/inngestAccess the Inngest execution dashboard at http://localhost:8288.
This project is fully optimized for single-click deployment on Vercel:
- Link your GitHub repository (
Mr-Prince2/Kuber) to your Vercel Dashboard. - In Build & Development Settings, set the Install Command override to:
npm install --legacy-peer-deps
- Add all environment variables in Vercel's Environment Variables settings.
- Deploy!
Licensed under the MIT License.