Skip to main content

🚀 Getting Started

Welcome! Before you create a classroom on Classmoji, you’ll first need to:

  1. Register as an instructor by filling out this form.
  2. Set up a GitHub Organization. This is essential because Classmoji uses GitHub repositories and issues to manage modules, assignments, and submissions.

🧱 Create a GitHub Organization​

  1. Go to github.com/organizations/new
  2. Choose a clear, short name for your classroom (e.g., schoolname-class-term, dartmouth-cs52-25s)
  3. Select the Free Plan (Classmoji works without GitHub Enterprise)
tip

Use a different GitHub Organization for each course and term to keep repositories separate and organized.

Once your GitHub Organization is ready, you're all set to create your classroom in Classmoji.

🛠️ Add the Classmoji GitHub App to Your Organization​

After creating your GitHub Organization, you'll need to authorize Classmoji to manage repositories, issues, and pull requests on your behalf.

  1. Click on the sign in button top right of the page

  2. Click Add new class button after you've signed in

  3. Select the organization you just created (e.g., schoolname-cs52-25s)

  4. Under Repository Access, choose:

    • ✅ All repositories (recommended), or
    • ⬜ Only select repositories (for advanced use)

  5. Click Install to authorize the app.

JUST TO BE CLEAR 😅

Classmoji only uses the permissions it needs to create student repositories, manage assignments (as issues).

Once installed, you will be redirected to your classrooms list and Classmoji will be connected to your GitHub Organization and ready to help you manage assignments and grading.