Skip to content

About

AI-powered learning platform that teaches coding step-by-step. Get guided hints and explanations, not instant solutions—build real skills through understanding.

Resources

Stars

31 stars

Watchers

0 watching

Forks

Repository files navigation

CodeCampus hero banner

CodeCampus

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

React 18 Vite 5 Tailwind CSS Firebase Vercel MIT License

Visual Journey

A guided tour through the main student and teacher experiences, using repository-relative paths so the images render on GitHub.

01. Home

CodeCampus home screen

02. Practice Problems

Practice problems screen

03. Learning Path

Learning path screen

04. Two Sum

Two Sum problem screen

05. VS Code

VS Code style workspace

06. Test

Test environment screen

07. Violations

Violation tracking screen

08. Achievement

Achievement center screen

09. Teacher Home

Teacher home screen

10. Students

Students screen

11. Teacher Views

Teacher views screen

12. Report

Report screen

13. Timeline

Timeline screen

The sections below add the deeper technical details, setup notes, and implementation overview.

CodeCampus tech stack graphic

Platform Highlights

IDE preview graphic Feature mosaic graphic
Learning loop graphic Security and proctoring graphic

IDE walkthrough graphic

🚀 Features

📝 VS Code-Style Workspace

  • Activity bar, file explorer, search, and AI assistant in a familiar IDE layout
  • Tabbed multi-file editing with Monaco Editor
  • Integrated terminal, auto-save, and breadcrumb navigation
  • Search across assignment files without leaving the workspace

📚 Assignments System

  • Subject-based organization for DSA, DBMS, Web Dev, OOP, and more
  • Deadline tracking with urgency colors and visible progress
  • Simulated JavaScript, Python, and SQL execution in browser
  • Paste detection, auto-save, and multi-file project support

🔒 Proctored Test Environment

  • Fullscreen enforcement with tab switch monitoring
  • Auto-submit after repeated warnings or time expiry
  • Question navigation with secure submission flow
  • Built for low-distraction, high-integrity exam sessions

🎓 Learning Features

  • Problem history, achievements, and gamification
  • Campus forums for collaborative discussion
  • Project showcase pages for portfolios and reviews
  • Guided learning paths and long-term skill progression

Architecture At A Glance

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]
Loading

💻 Tech Stack

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

⚡ Quick Start

Prerequisites

  • Node.js 16+ and npm
  • A Firebase project (free tier works!)

Setup Instructions

  1. Clone the repository

    git clone https://github.com/AdityaxDeore/codecampus.git
    cd codecampus
  2. Install dependencies

    npm install
  3. Configure Firebase ⚠️ IMPORTANT

    Without 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 .env and 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
  4. Start the development server

    npm start

    The app will open at http://localhost:4028

Troubleshooting

White screen after cloning?

  • Make sure you created the .env file with valid Firebase credentials
  • Check the browser console for specific error messages
  • Restart the dev server after adding credentials

Build fails?

  • Delete node_modules and package-lock.json, then run npm install again
  • Make sure you're using Node.js 16+

🛠️ Development

# 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 preview

Quick Navigation

Once 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

📁 Project Structure

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

Code Execution Engines

The platform supports in-browser code execution for multiple languages:

JavaScript

  • Sandboxed Execution - Runs in isolated Function context
  • Console Capture - Intercepts log, error, warn, and info
  • Error Handling - Displays runtime errors with stack traces

Python (Simulated)

  • Pattern Matching - Analyzes print() statements
  • TODO Detection - Warns about unimplemented code sections
  • Output Simulation - Mimics Python console behavior

SQL (Simulated)

  • Statement Parsing - Recognizes SELECT, CREATE, INSERT, ALTER, DROP
  • Query Feedback - Provides execution status for each statement
  • Multi-Statement Support - Handles semicolon-separated queries

🎮 Academic Integrity Features

  • 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

🧠 AI Assistant

  • 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

Performance

  • Route-based code splitting for optimal loading
  • Vendor chunk optimization
  • Lazy-loaded components with Suspense
  • Optimized bundle size with manual chunks

🧩 Adding Routes

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;
};

⌨️ Keyboard Shortcuts (Workspace)

Shortcut Action
Ctrl/Cmd + S Save current file
Ctrl/Cmd + B Toggle sidebar
Ctrl/Cmd + `` `` Toggle terminal

🖥️ Terminal Commands

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 commands

🎨 Styling

This 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

📱 Responsive Design

The app is built with responsive design using Tailwind CSS breakpoints.

📦 Deployment

Build the application for production:

npm run build

Vercel Deploy Panel

Deploy on Vercel Build command Output directory SPA rewrite

Environment 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-center load without refresh errors.

📄 License

MIT License - see LICENSE file for details.

Root Files

├── 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

About

AI-powered learning platform that teaches coding step-by-step. Get guided hints and explanations, not instant solutions—build real skills through understanding.

Resources

Stars

31 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages