A comprehensive full-stack platform for conducting AI-powered coding assessments with real-time code execution, multi-language support, and automated evaluation.

• Live Coding Assessment: Real-time coding tests with timer and auto-submission
• Multi-Language Support: JavaScript, Python, Java, C++, TypeScript
• Cloud Code Execution: Judge0 API integration with local fallbacks
• AI-Powered Analysis: Intelligent code evaluation and feedback
• Question Bank: LeetCode/HackerEarth style programming challenges
• Candidate Management: Complete assessment workflow from setup to results

• Monaco Code Editor: VS Code-like editing experience with syntax highlighting
• Real-time Test Execution: Run sample test cases during assessment
• Automatic Timeout Handling: Submit incomplete solutions when time expires
• Session Management: Persistent test sessions with candidate tracking
• Database Integration: MongoDB for candidate data and test results
• Responsive Design: Works seamlessly on desktop and mobile devices

• Multiple Difficulty Levels: Easy, Medium, Hard questions
• Sample Test Cases: Preview expected input/output before submission
• Live Code Testing: Run code against sample tests during development
• Progress Tracking: Question counter, timer, and completion status
• Professional UI: Clean, distraction-free assessment environment

┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ Frontend │ │ Backend │ │ Database │ │ (Next.js) │◄──►│ (Express.js) │◄──►│ (MongoDB) │ │ │ │ │ │ │ │ • React UI │ │ • REST API │ │ • Candidates │ │ • Monaco Editor │ │ • Code Execution │ │ • Questions │ │ • Timer System │ │ • AI Integration │ │ • Test Results │ └─────────────────┘ └──────────────────┘ └─────────────────┘ │ ▼ ┌──────────────────┐ │ Code Execution │ │ │ │ • Judge0 API │ │ • Local Compilers│ │ • Docker Support │ └──────────────────┘ 

• Framework: Next.js 14 with React 18
• Styling: TailwindCSS for modern UI components
• Code Editor: Monaco Editor (VS Code engine)
• Icons: Lucide React for consistent iconography
• HTTP Client: Fetch API with custom service layer

• Runtime: Node.js with Express.js framework
• Database: MongoDB with Mongoose ODM
• Code Execution: Judge0 API + local compiler fallbacks
• Security: CORS, input validation, rate limiting
• Session Management: In-memory sessions with MongoDB persistence

• Deployment: Render (backend) + Vercel (frontend)
• Code Execution: Judge0 cloud service with free tier fallback
• Database Hosting: MongoDB Atlas or local MongoDB
• Environment Management: dotenv for configuration

• Node.js: Version 18.0 or higher
• MongoDB: Local installation or MongoDB Atlas account
• Package Manager: npm or yarn
• Git: For version control
• Code Editor: VS Code recommended

# Clone the repository git clone https://github.com/muhammadnavas/AI_CodeEditor.git cd AI_CodeEditor # Install all dependencies npm run install-all # Or manually: # cd backend && npm install # cd ../frontend && npm install

cd backend cp .env.example .env

Edit backend/.env:

# Database Configuration MONGODB_URI=mongodb://localhost:27017/ai_codeeditor # Or use MongoDB Atlas: # MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/ai_codeeditor # Judge0 Configuration (Optional - has free fallback) JUDGE0_API_URL=https://judge0-ce.p.rapidapi.com JUDGE0_API_KEY=your-rapidapi-key JUDGE0_FREE_API_URL=https://judge0-ce.p.rapidapi.com # Server Configuration PORT=3001 CORS_ORIGIN=http://localhost:3000,https://your-frontend-domain.com NODE_ENV=development

cd frontend cp .env.example .env.local

Edit frontend/.env.local:

# Backend API URL NEXT_PUBLIC_API_URL=http://localhost:3001 # For production: https://your-backend-domain.com

# Start MongoDB service # macOS: brew services start mongodb/brew/mongodb-community # Windows: net start MongoDB # Linux: sudo systemctl start mongod # Verify connection mongosh # Should connect to mongodb://localhost:27017

Terminal 1 - Backend:

cd backend npm run dev # Server starts at http://localhost:3001

Terminal 2 - Frontend:

cd frontend npm run dev # Application available at http://localhost:3000

# Add candidate with coding questions cd backend node insert_candidate.js

Candidates can start assessments using:

• Candidate ID: CAND_001, CAND_002, etc.
• URL Parameters: ?candidateId=CAND_001
• Programmatic: window.startCodingTest('CAND_001')

Test results are automatically saved to the shortlistedcandidates collection with comprehensive data including:

• Code submissions for each question
• Time spent per question
• Scores and performance metrics
• Test completion status

• Open the assessment URL provided
• Enter your Candidate ID (e.g., CAND_001)
• Click "Start Coding Test"

• Read problem statement carefully
• Write code in the Monaco editor
• Select programming language (JavaScript, Python, Java, C++)
• Use "Run Code" to test against sample cases
• Click "Submit Code" when ready
• Complete all questions within time limits

• Automatic submission when time expires
• Simple "Test Ended" message displayed
• Results saved automatically for review

⚠️ Production Security Checklist:

• Use HTTPS for all production endpoints
• Implement API rate limiting
• Set strong MongoDB authentication
• Use environment-specific CORS origins
• Enable MongoDB Atlas IP whitelisting
• Monitor Judge0 API usage and costs
• Implement request logging and monitoring

1. Fork the repository
2. Create feature branch: git checkout -b feature/amazing-feature
3. Follow code style guidelines (ESLint + Prettier configured)
4. Add tests for new functionality
5. Commit changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Open Pull Request with detailed description

• Use ES6+ JavaScript features
• Follow React best practices for frontend
• Implement proper error handling
• Add JSDoc comments for functions
• Use meaningful variable and function names

• GitHub Issues: Report bugs or request features
• Email: Contact maintainers for enterprise support

• Real-time collaboration on code
• Video proctoring integration
• Advanced AI code review
• Custom question bank import
• Detailed analytics dashboard
• White-label customization
• Mobile app development
• Integration with ATS systems

Built with ❤️ by the AI CodeEditor team