DevPath is a modern SaaS learning platform where developers can explore curated roadmaps, track their progress, and master new skills. Built with Next.js 14 App Router, MongoDB, Prisma, and NextAuth.
| Layer | Technology |
|---|---|
| Framework | Next.js 14 (App Router) |
| Database | MongoDB Atlas |
| ORM | Prisma |
| Auth | NextAuth.js v4 (JWT + OAuth) |
| UI | Tailwind CSS + shadcn/ui |
| Roadmap Visualization | ReactFlow |
| Animations | Framer Motion |
| Validation | Zod |
| Caching | In-memory (Redis optional) |
git clone https://github.com/dipanshurdev/devpath.git
npm installCopy .env.example to .env and fill in the required values:
cp .env.example .envRequired variables:
DATABASE_URL=mongodb+srv://...
NEXTAUTH_SECRET=your-secret-here
NEXTAUTH_URL=http://localhost:3000Optional (for OAuth):
GITHUB_ID=...
GITHUB_SECRET=...
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...# Push schema to MongoDB and generate Prisma client
npm run setup:prisma
# Seed with sample roadmaps and an admin user
npm run db:seedDefault admin credentials (override via env):
- Email:
admin@devpath.dev - Password:
Admin@123456
npm run devOpen http://localhost:3000.
| Script | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for production |
npm run start |
Start production server |
npm run lint |
Run ESLint |
npm run lint:fix |
Run ESLint and auto-fix |
npm run type-check |
Run TypeScript type checking |
npm run prisma:generate |
Regenerate Prisma client |
npm run prisma:push |
Push schema changes to DB |
npm run prisma:studio |
Open Prisma Studio (DB GUI) |
npm run setup:prisma |
Generate + push schema |
npm run db:seed |
Seed database with sample data |
npm run db:reset |
Reset DB and re-seed |
npm run db:import |
Import roadmaps from JSON file |
devpath/
├── app/ # Next.js App Router pages and API routes
│ ├── api/ # API route handlers
│ │ ├── admin/stats/ # Admin stats endpoint
│ │ ├── auth/ # NextAuth + registration
│ │ ├── dashboard/ # Dashboard data
│ │ ├── roadmaps/ # Roadmap CRUD, likes, bookmarks, progress
│ │ ├── subscriptions/me/ # Current user subscription
│ │ └── users/ # User profile endpoints
│ ├── admin/ # Admin dashboard pages
│ ├── dashboard/ # User dashboard
│ ├── roadmaps/ # Roadmap list and detail pages
│ ├── login/ register/ # Auth pages
│ ├── pricing/ # Pricing page
│ ├── error.tsx # Global error boundary
│ └── not-found.tsx # 404 page
│
├── components/ # Shared UI components
│ ├── roadmaps/ # Roadmap-specific components (RoadmapFlow, etc.)
│ ├── navbar/ # Navigation components
│ ├── ui/ # shadcn/ui primitives
│ └── ...
│
├── lib/ # Shared utilities and configuration
│ ├── auth.ts # NextAuth configuration
│ ├── auth-utils.ts # requireAuth / requireAdmin helpers
│ ├── api-handler.ts # withErrorHandler wrapper + ApiError class
│ ├── cache.ts # In-memory / Redis cache abstraction
│ ├── config.ts # Central app config (pagination, TTLs, feature gates)
│ ├── env.ts # Zod-validated environment variables
│ ├── feature-gates.ts # checkFeatureAccess + subscription tier logic
│ ├── logger.ts # Structured JSON logger
│ └── prisma/
│ ├── client.ts # Prisma client singleton
│ └── queries.ts # All database query functions
│
├── features/ # Feature barrel exports
│ ├── auth/ # Auth feature re-exports
│ └── roadmaps/ # Roadmap feature re-exports
│
├── prisma/
│ └── schema.prisma # Database schema (MongoDB + Prisma)
│
├── scripts/
│ └── seed-sample-data.ts # Idempotent database seed script
│
├── tests/
│ └── data-isolation.test.ts # Integration tests for multi-user data isolation
│
├── types/
│ └── index.ts # Shared TypeScript types
│
├── middleware.ts # NextAuth route protection middleware
├── .env.example # Environment variable template
└── .eslintrc.json # ESLint configuration
- Authentication — Email/password + Google/GitHub OAuth via NextAuth
- Roadmaps — Browse, filter, search, and track progress through learning roadmaps
- Dashboard — Personal learning stats, weekly activity, in-progress and saved roadmaps
- Admin Panel — Create and manage roadmaps, view real-time platform stats
- Subscriptions — FREE/PRO/TEAM tier architecture with feature gating
- Caching — In-memory cache (Redis-ready) for roadmap list and detail endpoints
- Data Isolation — All user data (progress, bookmarks, likes) is scoped per user
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-feature - Commit your changes:
git commit -m 'Add my feature' - Push to the branch:
git push origin feature/my-feature - Open a pull request
See CONTRIBUTING.md for detailed guidelines.
MIT — see LICENSE for details.