Quick Start

Get the Gradescope Submitter running locally in under 5 minutes.

Step 1: Clone the Repository

git clone https://github.com/GGC-SD/gradescope-submitter.git
cd gradescope-submitter

Step 2: Install Dependencies

npm install

Step 3: Create Environment File

Create a .env file in the project root:

touch .env

Add the minimum required configuration:

PORT=3000
SECRET=your-secure-random-string-here
COURSE_ID=your-gradescope-course-id
TOKEN=your-gradescope-authenticity-token
COOKIE=your-gradescope-session-cookie

TIP

See Environment Configuration for details on getting these values.

Step 4: Start the Server

npm start

You should see:

Server running on http://localhost:3000

Step 5: Open the Demo

Open your browser and navigate to:

http://localhost:3000/mockD2L.html

You should see the mock D2L interface with the code editor embedded.

Test the Editor

1. Write some code in the editor:

print("Hello, World!")

2. Click "Run Code" to execute locally
3. See the output in the Output tab

Running Tests

Verify everything is working:

npm test

Expected output:

Test Suites: 3 passed, 3 total
Tests:       48 passed, 48 total

What's Next?

• Features — Learn about all the features
• Instructor Setup — Full production setup
• Student Guide — How students use the editor