Calendarium

How I became the main maintainer of Calendarium, the calendar and schedule planner of UMinho's Software Engineering students.

Calendarium's Logo

Calendarium ↗ GitHub ↗

When's the next exam? Which room is that class in again? For Software Engineering students at the University of Minho ↗, the answer has long been a click away on Calendarium: an open-source web app that brings exams, due dates, class schedules and the student center's activities together in one place.

The project was started in 2022 by some colleagues at CeSIUM ↗, the Software Engineering students' center, and I picked it up at a very early stage, in September of that same year. I stayed close to it for years, and became its main maintainer and contributor along the way.

features I've shipped
40+
views on a busy day
1,000+
views in February 2025 alone
24k

Calendarium's events view, with exams and due dates for the selected subjects

No More Circling Shifts

Building your weekly schedule used to be a ritual. The university publishes one giant table with every class and every shift, in a course where some classes have up to 12 shifts. So students went through it by hand, circling the shifts they were enrolled in, just to finally see what their week looked like.

Calendarium turns that into a few clicks:

UMinho's scheduleCalendarium
The official schedule, with every shift of every classThe same week in Calendarium, with only the selected shifts

How It Works

Everything is personalized from the sidebar, where you tell Calendarium what you're taking:

  1. Pick your subjects
    Choose them by year and semester, and their exams, projects and due dates show up in the events calendar, along with the dates every student cares about, like holidays and the start and end of each semester.
  2. Pick your shifts
    Switch to the schedule view and choose the shifts you're enrolled in, and your classes fill up the week.
  3. Get the details
    Tap any event or class to see when and where it is, and anything else worth knowing.

Choosing subjects in the sidebar

An eventA class
The details of an eventThe details of a class

Make It Yours

Custom themes
Pick your own color for every subject.
Export anywhere
Subscribe to your events or schedule from Google, Apple or Outlook Calendar, or download them as an iCal file.
Share codes
Send your selections to a friend as a code, so they don't have to pick everything again.
Notifications
Stay up to date with announcements and last-minute changes.
Installable
Add it to your phone's home screen and open it like any other app.
Dark mode
For late-night study sessions, of course.

Creating a custom theme

ExportShare
Exporting to an external calendarSharing selections with a code

Since exports are feeds rather than one-off files, any change in Calendarium, like an exam moving to another day, shows up in your calendar app on its own.

Behind the Scenes

  • Next.js
  • React
  • TypeScript
  • Tailwind CSS
  • React Big Calendar
  • Google Sheets API
  • Python
  • Selenium
  • GitHub Actions

Keeping a calendar like this up to date is most of the work, so a lot of Calendarium is about making that easy:

  1. Events live in a spreadsheetGoogle Sheets API
    Exams, due dates and notifications are kept in a Google Sheet, so anyone at CeSIUM can add or fix an event without touching the code.
  2. Schedules update themselvesSelenium
    Every week, a GitHub Action runs a Python scraper on the university's schedule portal to pick up any changes.
  3. A pull request lands
    The changes come in as a pull request, with a review requested from the project's most active contributor. Which, to this day, is still me.

Passing the Torch

Calendarium started out serving every Software Engineering student, from the Bachelor's to the Master's. But we wanted to take the idea behind it even further, so we teamed up with the board of the Bachelor's degree, and CeSIUM built a new platform: Pombo ↗.

Pombo works hand in hand with the degree itself. It's the official place where students check their schedules, and it's even where their shifts are assigned at the start of each year. Every student has their own account, can see exactly which shifts they were given, and can swap them with their colleagues. Some of Calendarium's features made the move too, like the events calendar. I made a small contribution to it, but Pombo was mainly built by other very talented people at CeSIUM.

Today, Bachelor's students use Pombo, while Calendarium is still the place to go for Master's students, until they eventually move to Pombo as well.

As for me, I no longer actively maintain Calendarium. With my degree coming to an end, I've gradually handed my responsibilities over to CeSIUM's new tech team, and the project is in good hands. It's still open source, though, so if you spot something missing, the repository has a guide to help you add it yourself.

Calendarium will forever be my baby <3. Working on it for all those years, and seeing so many people use it to make their lives a little easier, has been one of the most rewarding things I've ever done.