Quickstart

Quickstart: your first classroom

The path from nothing to a graded assignment, with each step linking into the right guide. Every step works from the web app or the CLI: the web app at classroom50.org needs no installation, and the command-line tools need a one-time install.

Before you start, make sure you have a GitHub organization on the Team or Enterprise plan; see Prerequisites and GitHub Education for the free upgrade through GitHub Education. New to the model? Skim How Classroom 50 Works first.

1. Set up the organization (one time)

Run the one-time setup, which creates the classroom50 repository in your organization and adds a service token for the grading workflows.

• Web: Set up an organization
• CLI: Set up the organization

2. Create a classroom

A classroom holds one course offering's roster, assignments, and scores; an organization can hold several.

• Web: Create a classroom
• CLI: Add a classroom

3. Add staff (optional)

Co-teachers, head TAs, and TAs each get a role with matching access.

• Web and CLI: Adding staff

4. Add students

Adding a student to the roster invites them to your organization; once they've joined, assignment accept links work.

• Web: Add students
• CLI: Invite students and Track students in the roster

5. Create an assignment

Register an assignment, optionally with a template repository for starter code and autograding tests.

• Web: Create an assignment
• CLI: Add assignments

6. Students accept and submit

Share the assignment's accept link (or the CLI commands) with your students.

• Web: Web Student Guide
• CLI: CLI Student Guide

7. Collect scores

Grading runs on each submission; collection gathers the results so you can review them on the submissions page and download a CSV.

• Web: Collect submissions
• CLI: Collect scores

Where next

• Course Lifecycle and End of Term for due dates, closing an assignment, and wrapping up the term.
• Managing Actions Cost if your roster is large.
• FAQ and Troubleshooting when something looks wrong.