Your Code, Your Community, Your Career.
A polished academic coding platform for computer science students with a VS Code-style IDE, proctored exams, guided practice, teacher review flows, and community learning.
Visual Journey · Features · Quick Start · Project Structure · Deployment
A guided tour through the main student and teacher experiences, using repository-relative paths so the images render on GitHub.
|
|
|
|
|
|
|
|
|
|
|
|
|
The sections below add the deeper technical details, setup notes, and implementation overview.
|
|
|
|
|
|
|
|
|
|
flowchart LR
A[Student/Teacher UI] --> B[React + Vite Client]
B --> C[Monaco IDE + Workspace]
B --> D[AI Assistant]
B --> E[Assignment Services]
B --> F[Proctored Testing]
D --> G[Contextual Hints]
E --> H[Firestore]
F --> I[Integrity Logs]
B --> J[Auth Gateway]
J --> K[Firebase Auth]
| Frontend | React 18, Vite 5, React Router 6, TailwindCSS, Framer Motion, Monaco Editor |
| UI System | Radix UI, cva button variants, styled-components, Lucide icons |
| Backend | Firebase Auth, Firestore, Express.js, MongoDB |
| Build & Deploy | Vite production builds, Docker, docker-compose, nginx, PostCSS |
- Node.js 16+ and npm
- A Firebase project (free tier works!)
-
Clone the repository
git clone https://github.com/AdityaxDeore/codecampus.git cd codecampus -
Install dependencies
npm install
-
Configure Firebase
⚠️ IMPORTANTWithout this step, you'll see a white screen!
# Copy the environment template cp .env.example .env # Mac/Linux copy .env.example .env # Windows
Then edit
.envand add your Firebase credentials:VITE_FIREBASE_API_KEY=your-actual-api-key VITE_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com VITE_FIREBASE_PROJECT_ID=your-project-id VITE_FIREBASE_APP_ID=your-app-id
Where to get these values:
- Go to Firebase Console
- Create a project (or select existing)
- Go to Project Settings → General → Your apps
- Click Web app → Config → Copy the values
-
Start the development server
npm start
The app will open at
http://localhost:4028
White screen after cloning?
- Make sure you created the
.envfile with valid Firebase credentials - Check the browser console for specific error messages
- Restart the dev server after adding credentials
Build fails?
- Delete
node_modulesandpackage-lock.json, then runnpm installagain - Make sure you're using Node.js 16+
# Install dependencies
npm install
# Start development server (runs on http://localhost:4028)
npm start
# Build for production
npm run build
# Preview production build
npm run previewOnce the server is running, access these routes:
/- Homepage/login- Authentication/student-dashboard- Student dashboard/assignments- Assignment listing/assignment-workspace?id=a1- VS Code workspace (BST assignment)/assignment-workspace?id=a2- Graph traversal assignment/assignment-workspace?id=a7- SQL normalization assignment/test- Proctored test environment/achievement-center- Leaderboards and achievements/campus-forums- Discussion forums
codecampus/
├── src/
│ ├── components/ # Reusable UI components
│ │ ├── ui/ # Button, Input, Header, etc.
│ │ ├── AppIcon.jsx # Icon wrapper component
│ │ ├── ErrorBoundary.jsx # Error handling
│ │ └── ProtectedRoute.jsx # Auth guards
│ ├── pages/
│ │ ├── assignment-workspace/ # VS Code-style IDE
│ │ ├── assignments/ # Assignment listing page
│ │ ├── test/ # Proctored test environment
│ │ ├── student-dashboard/ # Main student dashboard
│ │ ├── achievement-center/ # Leaderboards and badges
│ │ ├── campus-forums/ # Discussion forums
│ │ ├── problem-workspace/ # Problem solving IDE
│ │ ├── problems/ # Problem catalog
│ │ ├── homepage/ # Landing page
│ │ └── login/ # Authentication
│ ├── shared/ # Shared components and data
│ ├── lib/ # Firebase config and utilities
│ ├── contexts/ # React Context (Dark mode, etc.)
│ ├── hooks # Custom React hooks
│ ├── utils/ # Helper functions
│ └── styles/ # Global CSS and Tailwind
├── public/ # Static assets
├── docs/ # Documentation
│ ├── graphics/ # README visuals
│ └── screenshots/ # README screenshots
└── vite.config.mjs # Vite configuration
The platform supports in-browser code execution for multiple languages:
- Sandboxed Execution - Runs in isolated Function context
- Console Capture - Intercepts log, error, warn, and info
- Error Handling - Displays runtime errors with stack traces
- Pattern Matching - Analyzes print() statements
- TODO Detection - Warns about unimplemented code sections
- Output Simulation - Mimics Python console behavior
- Statement Parsing - Recognizes SELECT, CREATE, INSERT, ALTER, DROP
- Query Feedback - Provides execution status for each statement
- Multi-Statement Support - Handles semicolon-separated queries
- Copy-Paste Monitoring - Flags pastes over 10 words
- Timestamp Tracking - Records all paste events with word count
- Instructor Dashboard - Review flagged submissions (planned)
- Tab Switch Alerts - Monitors focus during proctored tests
- Fullscreen Lock - Enforces secure testing environment
- Context-Aware - Understands current assignment and language
- Hint-Based - Guides students without giving direct solutions
- Debugging Help - Analyzes errors and suggests fixes
- Quick Actions - Pre-built prompts for hints, debugging, and explanations
- Route-based code splitting for optimal loading
- Vendor chunk optimization
- Lazy-loaded components with Suspense
- Optimized bundle size with manual chunks
To add new routes to the application, update the Routes.jsx file:
import { useRoutes } from "react-router-dom";
import HomePage from "pages/HomePage";
import AboutPage from "pages/AboutPage";
const ProjectRoutes = () => {
let element = useRoutes([
{ path: "/", element: <HomePage /> },
{ path: "/about", element: <AboutPage /> },
// Add more routes as needed
]);
return element;
};| Shortcut | Action |
|---|---|
Ctrl/Cmd + S |
Save current file |
Ctrl/Cmd + B |
Toggle sidebar |
Ctrl/Cmd + `` `` |
Toggle terminal |
Available in the integrated terminal:
run # Execute current file
clear # Clear terminal history
ls # List all files in project
cat <file> # Display file contents
help # Show available commandsThis project uses Tailwind CSS for styling. The configuration includes:
- Forms plugin for form styling
- Typography plugin for text styling
- Aspect ratio plugin for responsive elements
- Container queries for component-specific responsive design
- Fluid typography for responsive text
- Animation utilities
The app is built with responsive design using Tailwind CSS breakpoints.
Build the application for production:
npm run buildEnvironment Validation Tips
- Confirm all
VITE_FIREBASE_*variables exist in Vercel before the first build. - If deploying under a subpath, set
VITE_BASE_PATH=/your-subpath/in Vercel. - After deploy, verify
/login,/assignments, and/achievement-centerload without refresh errors.
MIT License - see LICENSE file for details.
├── index.html # HTML template
├── package.json # Project dependencies and scripts
├── tailwind.config.js # Tailwind CSS configuration
└── vite.config.js # Vite configuration
Project by - Aditya Deore












