Groups & Assignments
The Groups & Assignments tab has a sidebar listing group sets and a detail panel showing groups, assignments, and repository templates for the selected group set.
Group sets
Section titled “Group sets”A group set is a named collection of groups (teams). Each group set organizes students differently — for example, one group set for lab partners and another for project teams. Assignments are linked to group sets, so each assignment uses one team organization.
There are three kinds of group sets:
System group sets
Section titled “System group sets”Created automatically and always present:
- Individual Students — every active student as a solo group. Use this for individual assignments where each student gets their own repository.
- Staff — all staff members in a single group.
System group sets cannot be renamed, deleted, or manually edited.
LMS group sets
Section titled “LMS group sets”Imported from your connected LMS (Canvas group sets or Moodle groupings). These are linked to the LMS source and can be synced to pull in membership changes.
To add an LMS group set, click the + button next to the LMS section header. This fetches available group sets from the LMS and lets you select which one to connect.
After connecting, click Sync on a group set to refresh its membership from the LMS.
Local group sets
Section titled “Local group sets”Created within repo-edu, either manually or by importing a CSV file.
- Create manually — use the dropdown menu to create an empty group set, then add groups and assign members
- Import from CSV — upload a CSV file with group names and member emails (see Output Formats for the format). A preview shows groups to create, matched members, and any unmatched emails before you confirm.
Local group sets can be freely renamed, edited, and deleted.
Managing groups within a group set
Section titled “Managing groups within a group set”Select a group set in the sidebar to see its groups in the detail panel. Each group shows:
- Group name — editable for local groups
- Members — shown as chips. Click to add or remove members.
- Assignments — badges showing which assignments use this group set
Adding a group
Section titled “Adding a group”Click Add Group in the detail panel to create a new group within the selected group set. Give it a name, then assign members.
Editing membership
Section titled “Editing membership”Click the member area of a group to open the member picker. You can add students from the roster or remove existing members. A student can belong to only one group within a group set — assigning them to a new group automatically removes them from their previous one.
Deleting a group
Section titled “Deleting a group”Remove a group from the set. Members are unassigned but remain in the roster.
Assignments
Section titled “Assignments”Assignments are created within a group set and represent a deliverable that needs repositories. Each assignment has:
- Name — the assignment display name (e.g., “Project 1”, “Lab 3”)
- Group set — which team organization to use (inherited from where you create it)
Creating an assignment
Section titled “Creating an assignment”In the detail panel for a group set, click Add Assignment. Enter a name, and the assignment is linked to that group set.
Repository template
Section titled “Repository template”Each group set can have a repository template that applies to all its assignments. The template defines:
- Owner and name — the source repository on your Git provider (e.g.,
my-org/project-template) - Visibility — whether created repositories are private, internal, or public
When repositories are created for an assignment, they are initialized with the template’s content and configured with the specified visibility.
Exporting group sets
Section titled “Exporting group sets”Select a group set and click Export to download it as:
- CSV — one row per member per group, with group name, member name, and email columns
- YAML — Repobee-compatible team list format, for use with the Repobee tool
Reimporting a group set
Section titled “Reimporting a group set”For local group sets imported from CSV, you can reimport to update the groups. The reimport shows a diff preview: groups added, removed, renamed, and members changed. Review the changes before confirming.
Validation
Section titled “Validation”Before running repository operations, validate your setup. The desktop app shows validation issues as cards that you can click to see affected members. Common issues:
- Students missing Git usernames
- Empty groups
- Duplicate repository names
- Missing Git connection or organization
See Repository Setup for the full validation and creation workflow.