CodeCrux is a full-stack DSA learning platform designed for coding interview preparation. It features AI-powered mentorship, dynamic content management, progress tracking, and admin-controlled data. Built with modern MERN stack architecture and Google Gemini AI integration.
๐ฏ Dynamic Content Management
- Admin Dashboard - Full CRUD operations for sheets and tutorials
- Database-Driven - All content stored in MongoDB with real-time updates
- Progress Tracking - ObjectId relationships for user completion status
- Role-Based Access - Admin-only content management (ashutoshmaurya585@gmail.com)
๐ Learning Resources
- Popular DSA Sheets - Striver's SDE, Love Babbar 450, NeetCode 150, Blind 75, etc.
- Video Tutorials - Curated programming tutorials with metadata
- 6-Stage Roadmap - Structured learning path from basics to advanced
- Search & Filter - Advanced filtering by category, difficulty, and tags
๐ค AI-Powered Mentorship
- Google Gemini AI - 24/7 intelligent coding mentor
- Persistent Chat History - Conversations saved to user profile
- Context-Aware - AI understands your learning progress
- Real-time Streaming - Live AI responses with typing indicators
๐ User Progress & Analytics
- Completion Tracking - Mark sheets/tutorials as completed
- Personal Dashboard - Real-time progress statistics
- Profile Management - User data with completion history
- Admin Access Button - Quick admin panel access for authorized users
๐จ Modern User Experience
- Dark/Light Themes - Persistent theme preference
- Responsive Design - Mobile-first approach for all devices
- Real-time Notifications - Toast messages for user actions
- Fast Performance - Optimized bundle size and clean architecture
๐จ Frontend (React SPA)
- โ๏ธ React 19.1.0: Modern React with hooks and context API
- โก Vite: Lightning-fast development server and optimized builds
- ๐จ Tailwind CSS: Utility-first responsive design
- ๐งญ React Router DOM: Client-side routing with protected routes
- ๐ React Toastify: Toast notifications for user feedback
- ๐ฏ Lucide React: Consistent icon library
- ๐ Axios: HTTP client with cookie support
- ๐ค Google GenAI: Direct Gemini AI chat integration
๐ง Backend (Node.js API)
- ๐ Express.js 5.1.0: RESTful API server with middleware
- ๐๏ธ MongoDB + Mongoose: Document database with schema validation
- ๏ฟฝ JWT Authentication: Secure token-based auth with cookies
- ๐ bcryptjs: Password hashing and security
- ๐ง Nodemailer: Email verification and password reset
- ๐ช Cookie Parser: HTTP cookie handling
- ๐ CORS: Cross-origin resource sharing
- ๐ง Nodemon: Development auto-reload
๐๏ธ Database Schema
- ๏ฟฝ User Model: Profile, auth, progress tracking with ObjectId refs
- ๐ Sheet Model: DSA sheets with metadata, tags, and ratings
- ๐ฅ Tutorial Model: Video tutorials with instructor and duration info
- ๏ฟฝ Chat History: Persistent AI conversations per user
๐ก๏ธ Security & Performance
- ๐ Role-Based Access: Admin-only routes and operations
- ๐ JWT + HTTP-Only Cookies: Secure authentication flow
- ๐ง Email Verification: OTP-based account verification
- โก Optimized Bundle: Tree-shaking and code splitting
- ๏ฟฝ Clean Architecture: Separation of concerns and DRY principles
CodeCrux/
โโโ codecrux-frontend/ # React Frontend Application
โ โโโ src/
โ โ โโโ components/ # Reusable UI Components (14 files)
โ โ โ โโโ ChatInput.jsx # AI chat input interface
โ โ โ โโโ ChatMessages.jsx # AI chat message display
โ โ โ โโโ Dashboard.jsx # User progress dashboard
โ โ โ โโโ SheetCard.jsx # Practice sheet cards
โ โ โ โโโ TutorialCard.jsx # Video tutorial cards
โ โ โ โโโ ... # Navigation, search, etc.
โ โ โโโ pages/ # Main Application Pages (11 files)
โ โ โ โโโ AdminDashboard.jsx # Content management interface
โ โ โ โโโ MentorAI.jsx # AI chat page
โ โ โ โโโ Sheet.jsx # Practice sheets listing
โ โ โ โโโ Tutorials.jsx # Video tutorials listing
โ โ โ โโโ Profile.jsx # User profile & progress
โ โ โ โโโ ... # Auth, home, roadmap pages
โ โ โโโ contexts/ # React Context Providers (2 files)
โ โ โ โโโ AppContext.jsx # Global state & API calls
โ โ โ โโโ DarkModeContext.jsx # Theme management
โ โ โโโ hooks/ # Custom React Hooks (1 file)
โ โ โ โโโ useAIMentor.js # AI chat functionality
โ โ โโโ data/ # Static Data (1 file)
โ โ โ โโโ RoadmapData.jsx # Learning roadmap structure
โ โ โโโ assets/ # Images, icons, utilities (10 files)
โ โโโ package.json
โโโ codecrux-server/ # Express Backend API
โ โโโ controllers/ # Business Logic Controllers (4 files)
โ โ โโโ authController.js # Authentication logic
โ โ โโโ userController.js # User data management
โ โ โโโ adminController.js # Admin CRUD operations
โ โ โโโ publicController.js # Public data endpoints
โ โโโ models/ # MongoDB Schemas (3 files)
โ โ โโโ userModel.js # User schema with progress refs
โ โ โโโ sheetModel.js # Practice sheet schema
โ โ โโโ tutorialModel.js # Tutorial video schema
โ โโโ routes/ # API Route Definitions (4 files)
โ โ โโโ authRoutes.js # Authentication endpoints
โ โ โโโ userRoutes.js # User data endpoints
โ โ โโโ adminRoutes.js # Admin-only endpoints
โ โ โโโ publicRoutes.js # Public data endpoints
โ โโโ middleware/ # Custom Middleware (1 file)
โ โ โโโ userAuth.js # JWT authentication middleware
โ โโโ config/ # Configuration Files (2 files)
โ โ โโโ mongodb.js # Database connection
โ โ โโโ nodemailer.js # Email service config
โ โโโ server.js # Express server entry point
โ โโโ package.json
โ โโโ API_DOCUMENTATION.md # Complete API reference
โโโ README.md # This file
- Frontend: https://code-crux-ten.vercel.app
- Backend API: https://codecrux1.onrender.com
- Database: MongoDB Atlas (Cloud)
Deployment Architecture:
- Frontend deployed on Vercel (React SPA with optimized routing)
- Backend deployed on Render (Node.js API with Docker support)
- Database hosted on MongoDB Atlas (Cloud database service)
- Node.js (v18+) - JavaScript runtime
- MongoDB (local installation or MongoDB Atlas cloud)
- Google Gemini API Key - For AI chat functionality
- Email Service - Gmail SMTP or similar for auth emails
- Clone & Setup
git clone https://github.com/aashutosh585/CodeCrux.git
cd CodeCrux
# Install all dependencies
npm run install:all # or install manually below- Manual Installation
# Backend dependencies
cd codecrux-server && npm install
# Frontend dependencies
cd ../codecrux-frontend && npm install- Environment Configuration
Backend Environment (codecrux-server/.env):
# Database
MONGODB_URI=mongodb+srv://your-username:your-password@cluster.mongodb.net/codecrux
# JWT Authentication
JWT_SECRET=your-super-secret-jwt-key-minimum-32-characters
# Email Service (Brevo SMTP)
SMTP_USER=your-smtp-user@smtp-brevo.com
SMTP_PASS=your-brevo-api-key
SENDER_EMAIL=your-email@gmail.com
# Google OAuth
GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-google-client-secret
GOOGLE_CALLBACK_URL=http://localhost:4000/api/auth/google/callback
# Server Configuration
PORT=4000
NODE_ENV=developmentFrontend Environment (codecrux-frontend/.env):
# Backend API URL
VITE_API_URL=http://localhost:4000/api
# Google Gemini AI API Key
VITE_GEMINI_API_KEY=your-gemini-api-key-here- Database Setup
# Start MongoDB service (if local)
# Windows: net start MongoDB
# macOS: brew services start mongodb
# Linux: sudo systemctl start mongod
# MongoDB will automatically create collections on first run- Start Development Servers
# Terminal 1 - Backend API (Port 4000)
cd codecrux-server && npm start
# Terminal 2 - Frontend React App (Port 5173)
cd codecrux-frontend && npm run dev- Access Application
- Frontend: http://localhost:5173
- Backend API: http://localhost:4000
- API Documentation: codecrux-server/API_DOCUMENTATION.md
POST /register # User registration with email verification
POST /login # User login with JWT token
POST /logout # User logout and token cleanup
GET /is-auth # Check current authentication status
POST /send-verify-otp # Send email verification OTP
POST /verify-otp # Verify email with OTP code
POST /send-reset-otp # Send password reset OTP
POST /reset-password # Reset password with OTP
GET /data # Get user profile and progress data
POST /chat/message # Save individual AI chat message
POST /chat/history # Bulk save chat conversation
DELETE /chat/history # Clear user's chat history
POST /toggle-sheet # Toggle sheet completion status
POST /toggle-tutorial # Toggle tutorial completion status
POST /check # Verify admin access permissions
GET /sheets # Get all sheets (admin view)
POST /sheets # Create new practice sheet
PUT /sheets/:id # Update existing sheet
DELETE /sheets/:id # Delete practice sheet
GET /tutorials # Get all tutorials (admin view)
POST /tutorials # Create new tutorial
PUT /tutorials/:id # Update existing tutorial
DELETE /tutorials/:id # Delete tutorial
GET /sheets # Get all published practice sheets
GET /tutorials # Get all published video tutorials
๐ Complete API Documentation: See
codecrux-server/API_DOCUMENTATION.mdfor detailed request/response schemas
Admin Dashboard (AdminDashboard.jsx)
- Content Management: Full CRUD operations for sheets and tutorials
- Role-Based Access: Only
ashutoshmaurya585@gmail.comcan access admin panel - Real-time Updates: Changes reflect immediately across the platform
- Data Validation: Form validation with error handling and success notifications
Access Method:
- Login with admin email โ Go to Profile โ Click "Admin Dashboard" button
AI Mentor System (MentorAI.jsx + useAIMentor.js)
- Google Gemini AI: Real-time chat with streaming responses
- Persistent History: All conversations saved to user profile
- Context Awareness: AI understands your learning progress and completed items
- Error Handling: Graceful fallbacks and retry mechanisms
User Progress Tracking
- ObjectId Relationships: MongoDB references between users and completed content
- Real-time Updates: Instant progress reflection across dashboard and profile
- Toggle Completion: Mark sheets/tutorials as done with one click
- Analytics: Dashboard shows completed items, chat history count, and total progress
Dynamic Content Management
- Sheet Model: Title, description, author, difficulty, problems count, rating, tags, etc.
- Tutorial Model: Instructor, duration, thumbnail, URL, student count, level, etc.
- User Model: Profile data with ObjectId arrays referencing completed sheets/tutorials
- Populated Queries: Efficient data fetching with MongoDB population
Frontend (Client)
npm run dev # Start Vite development server (http://localhost:5173)
npm run build # Build optimized production bundle
npm run preview # Preview production build locally
npm run lint # Run ESLint code analysisBackend (CodeCrux Server)
npm start # Start production server
npm run dev # Start with nodemon auto-reloadRoot Scripts
npm run install:all # Install dependencies for both frontend and backend
npm run dev:full # Start both frontend and backend concurrently
npm run build:all # Build both applications for production- Frontend: Deployed on Vercel โ https://code-crux-ten.vercel.app
- Backend: Deployed on Render โ https://codecrux1.onrender.com
- Database: MongoDB Atlas (Cloud)
cd codecrux-frontend
npm run build
# Deploy dist/ folder or connect GitHub repository to VercelVercel Configuration (vercel.json):
{
"rewrites": [
{ "source": "/(.*)", "destination": "/" }
]
}cd codecrux-server
# Set environment variables in Render dashboard
# Deploy with Node.js runtime using start command# Backend Production (Render)
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/codecrux
JWT_SECRET=your-production-jwt-secret-32-chars-minimum
SMTP_USER=your-brevo-smtp-user
SMTP_PASS=your-brevo-api-key
SENDER_EMAIL=your-email@domain.com
GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-google-client-secret
GOOGLE_CALLBACK_URL=https://codecrux1.onrender.com/api/auth/google/callback
PORT=4000
NODE_ENV=production
# Frontend Production (Vercel)
VITE_API_URL=https://codecrux1.onrender.com/api
VITE_GEMINI_API_KEY=your-production-gemini-key- ESLint Configuration: Consistent code formatting and error detection
- Component Structure: Functional components with hooks pattern
- Clean Architecture: Separation of concerns (controllers, models, routes)
- Error Handling: Comprehensive try-catch blocks with user-friendly messages
# Access MongoDB shell (if using local MongoDB)
mongo codecrux
# Useful queries for development
db.users.find().pretty() # View all users
db.sheets.find().pretty() # View all practice sheets
db.tutorials.find().pretty() # View all tutorials
db.users.findOne({email: "admin@example.com"}) # Find specific userWe welcome contributions! Please follow these steps:
- Fork the Repository
git clone https://github.com/your-username/CodeCrux.git
cd CodeCrux- Create Feature Branch
git checkout -b feature/your-feature-name
# Examples: feature/admin-bulk-import, feature/progress-analytics- Development Setup
npm run install:all # Install dependencies
npm run dev:full # Start both servers- Make Changes & Test
- Follow existing code patterns
- Test both frontend and backend changes
- Ensure admin functionality works
- Verify AI chat integration
- Commit & Push
git add .
git commit -m "feat: add your feature description"
git push origin feature/your-feature-name- Create Pull Request
- Describe your changes clearly
- Include screenshots if UI changes
- Reference any related issues
- ๐จ UI/UX Improvements: Better responsive design, animations
- ๐ค AI Features: Enhanced chat capabilities, smart recommendations
- ๐ Analytics: Advanced progress tracking, learning insights
- ๐ง Admin Tools: Bulk operations, content moderation
- ๐ Content: More DSA sheets, tutorial curation
- ๐ Bug Fixes: Performance optimizations, error handling
Ashutosh Maurya
- ๐ GitHub: @aashutosh585
- ๐ง Email: ashutoshmaurya585@gmail.com
- ๐ผ LinkedIn: Connect with me
- ๐ฆ Twitter: @aashutosh585
- ๐ค Google Gemini AI - Powering the intelligent mentorship system
- ๐๏ธ MongoDB - Flexible document database for dynamic content
- โ๏ธ React Team - Amazing frontend library and ecosystem
- โก Vite - Lightning-fast development experience
- ๐จ Tailwind CSS - Beautiful utility-first styling
- ๐ Open Source Community - Inspiration and continuous learning
Current Status: โ Production Ready
- ๐ฏ 11 Pages - Complete user journey from auth to admin
- ๐งฉ 14 Components - Reusable, optimized UI components
- ๐ 19 API Endpoints - Full CRUD operations with security
- ๐ 3 Database Models - Efficient data relationships
- ๐ค AI Integration - Real-time chat with conversation history
Upcoming Features (v2.0):
- ๐ฑ Mobile App - React Native version
- ๐ฎ Gamification - Points, badges, leaderboards
- ๐ฅ Community Features - Discussion forums, peer learning
- ๐ Advanced Analytics - Learning patterns, recommendations
- ๐ API Integrations - LeetCode sync, GitHub portfolio
- ๐จ Themes - Custom color schemes, personalization
๐ Built with passion for the coding community
โญ Star this repo โข ๐ Report Issues โข ๐ก Request Features โข ๐ Documentation
Made with โค๏ธ in India ๐ฎ๐ณ