PathForge solves the #1 problem for CSE students: no clear, personalised path from where they are today to a placement offer at their dream company.
Most students waste months jumping between random YouTube playlists, LeetCode problems without strategy, and generic roadmaps that don't account for their semester, skills, or target role. PathForge gives them an AI-powered system that adapts to them — acting as a personal placement coach, roadmap planner, and accountability partner.
Built for the ~1.5 million CSE students who graduate in India every year.
Sign in with Google or use the guest account to explore the full platform.
Identifies your best-fit career path (SDE, Data Science, DevOps, ML Engineer, etc.) based on your skills, interests, and semester — powered by Groq Llama 3.3-70B.
Personalised week-by-week preparation plan generated by AI. Adapts based on your target role, current skills, and available time. Weekly check-ins keep it current.
Track all 455 problems from Striver's A2Z DSA sheet with XP rewards, difficulty filters, topic-wise progress, and a built-in streak system. Marks weakest topics for priority practice.
Company-specific prep paths for Google, Microsoft, Amazon, Flipkart, Goldman Sachs, Razorpay, Infosys, and Adobe — including:
- Round-by-round breakdown
- OA pattern and timing
- Must-know topics (weighted by frequency)
- Past interview questions with difficulty tags
- Live readiness score based on your DSA progress
- DSA gap calculator (you need X, you have Y)
- Insider tips from students who got offers
Real-time placement readiness score across DSA, projects, communication, core subjects, and profile completeness. Tracks progress over time.
Auto-generated daily task list based on your roadmap stage, weakest DSA topics, active courses, and target role. Subject rotation by weekday. XP rewards on completion. localStorage persistence.
Structured learning paths for OS, DBMS, CN, OOP, System Design, COA, and Discrete Math — with curated free resources, topic chips, exam tips, and interview preparation notes.
Calculate CGPA across all semesters, check company eligibility cutoffs, and see which companies you qualify for based on your current score.
Real placement experiences from students who cracked Google, Microsoft, Amazon, Flipkart, and Razorpay — with expandable full stories and numbered tips from each person.
Connect with batchmates, view activity feeds, and compete on XP leaderboards. Accountability buddy system with missed-day nudges after 6pm.
Create and join placement preparation challenges with peers. Live competition tracking.
Auto-suggests LinkedIn skill additions and resume updates based on completed milestones. Dismissable tips that persist across sessions.
| Layer | Technology |
|---|---|
| Frontend | Next.js 14 (App Router), TypeScript, Tailwind CSS |
| Animations | Framer Motion (spring physics, AnimatePresence) |
| Backend | Next.js API Routes (serverless) + FastAPI (Python) |
| Database | Supabase (PostgreSQL) with Row Level Security |
| Auth | Supabase Auth — Google OAuth + Email/Password |
| AI | Groq API (Llama 3.3-70B) with deterministic fallbacks |
| Payments | Razorpay (INR, UPI, cards, net banking) |
| Deployment | Vercel (frontend) + Railway (backend) |
| PWA | @ducanh2912/next-pwa — installable on Android & iOS |
| Icons | Lucide React |
| Fonts | Space Grotesk (headings) + Inter (body) |
┌─────────────────────────────────────────────────────┐
│ Next.js Frontend │
│ App Router · TypeScript · Tailwind · Framer Motion │
└──────────────────────┬──────────────────────────────┘
│
┌────────────┴────────────┐
│ │
┌─────────▼──────────┐ ┌─────────▼──────────┐
│ Next.js API Routes │ │ FastAPI Backend │
│ /api/tasks/today │ │ AI agents │
│ /api/payments/* │ │ DSA stats │
│ /api/admin │ │ Readiness score │
└─────────┬──────────┘ └─────────┬──────────┘
│ │
└────────────┬────────────┘
│
┌────────────▼────────────┐
│ Supabase │
│ PostgreSQL + Auth + RLS │
└─────────────────────────┘
Key architectural decisions:
- Stateless middleware — no Supabase network calls in Edge middleware (prevents 504 timeouts). Auth cookies inspected directly.
- Service role key server-side only — admin operations and payment verification use the service role key exclusively in API routes, never exposed to the browser.
- Chunked cookie detection — Google OAuth tokens are large and get split across multiple cookies (
sb-xxx-auth-token.0,.1). Middleware usesincludes()notendsWith()to detect all variants. - AI with deterministic fallbacks — every Groq API call has a pre-built fallback response so the app works even when the AI is unavailable.
users — profile, xp, streak, tier, target_role, college
roadmap_plans — AI-generated 16-week plan per user
roadmap_tasks — individual tasks within each plan
dsa_sheets — problem sheets (Striver A2Z)
dsa_problems — 455 individual problems with topics
dsa_progress — per-user problem completion
courses — user-tracked online courses
readiness_scores — placement readiness over time
friendships — peer connections
activity_feed — friend activity events
challenges — peer challenges + participants
notifications — in-app notification systemAll tables have Row Level Security (RLS) enabled. Admin operations bypass RLS via service role key on the server.
- Node.js 18+
- A Supabase project
- Razorpay account (for payments)
- Groq API key (for AI features)
# Clone the repository
git clone https://github.com/kratos0718/pathforge.git
cd pathforge
# Install dependencies
npm install
# Copy environment variables
cp .env.local.example .env.localFill in .env.local:
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
NEXT_PUBLIC_BACKEND_URL=your_fastapi_backend_url
RAZORPAY_KEY_ID=rzp_test_xxxxxxxxxxxx
RAZORPAY_KEY_SECRET=your_razorpay_secret
NEXT_PUBLIC_ADMIN_EMAILS=your@email.com# Run the development server
npm run dev# Apply the schema to your Supabase project
# Go to Supabase → SQL Editor → paste contents of:
supabase/schema.sqlPathForge is a full Progressive Web App.
Android: Chrome → 3-dot menu → "Add to Home Screen"
iOS: Safari → Share button → "Add to Home Screen"
Opens fullscreen with the PathForge logo, violet theme, and app shortcuts for Tasks, DSA, and Roadmap.
Razorpay integration with server-side HMAC signature verification:
User clicks Upgrade (₹99/mo)
→ /api/payments/create-order (creates Razorpay order)
→ Razorpay checkout UI opens
→ User pays via UPI / card / net banking
→ /api/payments/verify (validates HMAC signature)
→ users.tier = 'premium' + 500 XP awarded
The Key Secret never leaves the server.
src/
├── app/
│ ├── api/ # Serverless API routes
│ │ ├── admin/ # Admin data endpoint
│ │ ├── payments/ # Razorpay create-order + verify
│ │ └── tasks/today/ # Smart daily task generator
│ ├── auth/ # Login + Google OAuth callback
│ ├── dashboard/ # Main dashboard
│ ├── company/ # Company intelligence hub
│ ├── dsa/ # DSA problem tracker
│ ├── roadmap/ # 16-week roadmap
│ ├── compass/ # AI role compass
│ ├── subjects/ # CSE subject paths
│ ├── score/ # Readiness score
│ ├── upgrade/ # Premium subscription
│ └── admin/ # Admin panel
├── components/
│ └── ui/ # Reusable components + custom cursor
├── lib/
│ └── supabase.ts # Supabase client
└── middleware.ts # Edge auth middleware
1. Vercel Edge Middleware 504 Timeout
Supabase getUser() and getSession() make outbound network calls which timeout in Vercel's Edge runtime. Solved by making middleware completely stateless — only inspects cookie names to determine auth status.
2. Google OAuth Redirect Loop
OAuth tokens are large and get chunked into multiple cookies. The middleware only detected single-cookie sessions. Fixed by changing endsWith('-auth-token') to includes('-auth-token').
3. Session Cookies Lost After OAuth
NextResponse.redirect() doesn't inherit cookies set via next/headers. After code exchange, session cookies were being lost. Fixed by buffering cookies in an array and attaching them directly to the redirect response.
4. TypeScript Set Iteration
JSON.stringify([...Set]) fails without downlevelIteration. Fixed with Array.from().
| Dashboard | Company Intel | DSA Tracker |
|---|---|---|
| Daily tasks, stats, modules | Company readiness scores | 455-problem tracker |
| Interview Stories | Roadmap | Upgrade |
|---|---|---|
| Real placement experiences | 16-week AI plan | Razorpay payment |
- AI Mock Interview — practice with real-time AI feedback
- Resume Builder — auto-generate ATS resume from profile data
- Job Application Tracker — kanban board for applications
- Email reminders — streak protection, weekly digest (Resend)
- Real-time leaderboard — Supabase Realtime
- College leaderboard — rank within your college batch
MIT — free to use, modify, and distribute.
Built with ❤️ for every CSE student grinding for their dream placement.