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, zero-asset text animations, an AI-powered receipt scanner, robust rate-limiting security shields, and complex background automation loops, Kuber transforms standard expense tracking into an intelligent personal asset management experience.
A premium, low-contrast dark interface optimized for data-dense charting layouts using Tailwind CSS.
Zero-asset custom CSS text effects (animate-logo-fade) inside a clean glassmorphic header, eliminating image caching locks and enhancing First Contentful Paint (FCP).
A fluid layout grid wrapper using Tailwind breakpoints designed to effortlessly transition from mobile matrix scales to wide tablet/desktop monitors.
Instant visual state updates via React 19's useOptimistic hook, keeping operations fast by bypassing server action roundtrips.
Smart Receipt Scanner: Upload receipt images directly to have the platform parse line items, suggest semantic category associations, structure timestamps, and calculate totals instantly.
Automated first-of-the-month background evaluation pipelines that read user patterns and write targeted, actionable financial guidance.
Advanced token-bucket controllers managing mutations across API networks to protect the server from automated high-frequency script attacks.
Core traffic filtering layers safeguarding platform pathways from malicious automated agents while safely allowing standard search engine and web crawlers.
Scheduled background operations checking operational metrics, managing budgets, and distributing monthly email digests natively.
Sophisticated event batching controls restricting execution queues to 10 instances per minute per user to keep multi-user processes stable.
Next.js (App Router, Turbopack Compilation Engine)
React 19, Tailwind CSS, Shadcn UI Components, Lucide Icons, React Spinners
Clerk Auth Engine (Optimized with Custom Dark Theme Elements)
Supabase (PostgreSQL), Prisma ORM (Relational Data Pipelines)
Google Generative AI (Gemini 1.5 Flash Model Core)
Arcjet Security Integration Shield
Inngest Event Pipeline Framework
Resend API Core paired with React Email Components
Recharts (Responsive Vector Area/Bar Graphs)
To spin up Kuber locally, ensure your machine has Node.js installed, then follow this step-by-step setup script:
Clone the repository path and initialize your configuration layer:
git clone https://github.com/Mr-Prince2/ai_finance_platform.git
cd ai_finance_platform
Create an .env or .env.local file in your root folder and supply your infrastructure tokens:Code snippet
# Clerk Security Environment
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
# Database Direct and Pooling Vectors
DATABASE_URL="postgresql://..."
DIRECT_URL="postgresql://..."
# Third Party AI Providers & Middleware Services
GEMINI_API_KEY=AIzaSy...
ARCJET_KEY=ajkey_...
RESEND_API_KEY=re_...
Install the explicit dependency packages matching your platform's React 19 and Next.js layers:
npm install --legacy-peer-depsPush your local structural configurations straight to your relational database instances via Prisma:
npx prisma migrate dev --name initLaunch your local Next.js environment running with native Turbopack compilation:
npm run devYour user dashboard will load live at http://localhost:3000.
Open a separate terminal window to host your background event-driven micro-services locally:
npx inngest-cli@latest dev -u http://localhost:3000/api/inngestAccess the background execution metrics and manual task invocation board at http://localhost:8288.
This project is fully optimized for single-click deployments on Vercel:
Link your GitHub repository to your Vercel Dashboard.
In the Build and Output Settings, append your legacy resolution installer rules into the install command field override:
npm install --legacy-peer-depsSet your custom project environment variables within Vercel's securely managed fields.
Add the official Inngest Integration extension through your Vercel Project Integration settings to allow sync engines to complete automatically.