Puckdex

About the project

The idea of this project was to provide an easy way to get all the home games of the Hurricanes into my calendar. All options I found had both home and away, but I wanted to have them appear differently. Then I found the NHL API (unofficial reference) that can give us each team's schedule and decided to create something similar to footcal.

How to use this website

You can expand the sections below to see examples of how to use one of our calendars.

Choose the calendar you want
First, you will go to our home page (https://puckdex.cbdm.app/), scroll to the team you want the calendar, click on the Choose Type button, and select between the three options (full, home-only, away-only).

The image below shows an example where we select the Carolina Hurricanes (1) and then the calendar with only home games (2).
Figure showing the UI when you click on choose type for one of the teams in our homepage.
Choosing the home-only calendar for the Carolina Hurricanes

Confirming you have the URL
After you click on the calendar type for one of the teams, you will see a confirmation message similar to the image below.
Figure showing a message confirming the calendar URL has been copied.
Confirmation that the calendar URL has been copied

If you see that, you're done! You have successfully found the URL for the calendar you want :)
If you paste the contents of your clipboard somewhere they should have:
https://puckdex.cbdm.app/home/CAR.ics

The beginning should always be the same (https://puckdex.cbdm.app/), and there are two parts that will change if you select a team different than the Canes and a calendar different than home-only games:
  1. The end will change from /CAR.ics to your team, e.g., for the Islanders that would be /NYI.ics
  2. Then home will be full if you chose "All Games" or away if you chose "Only Away Games".
Now you can use this URL to add the calendar to your favorite calendar application.

At this part, you should already have a calendar URL you want to use from the previous step. For this example, we will use the URL created on our previous example: https://puckdex.cbdm.app/home/CAR.ics
This URL will contain only the home games for the Carolina Hurricanes.

Adding URL to Google Calendar
First, you will want to navigate to https://calendar.google.com; in there you will click on the plus-sign button next to "Other calendars" (1), like in the image below:
Google calendar UI, image indicates that you should choose the option to add another calendar.
Google calendar option to add a new calendar

Then, you will choose the option to add a new calendar "From URL" (2):
Google calendar UI, image indicates that you should choose the option to add a calendar from an URL.
Adding new calendar to gcal from an URL

In the new page that will show up, you will paste the calendar URL you have copied into the "URL of calendar" box (3) and click on the "Add calendar" button (4):
Google calendar UI, image shows you should use the calendar URL you created before to add a new calendar
Using the puckdex calendar URL

After you click "Add calendar", a new page should show up with the settings of the calendar you just added (5), and you have the option to rename the calendar to something that makes sense to you (6):
Google calendar UI, image shows the settings of the newly created calendar where you can rename it
Renaming the puckdex calendar

In this example, I named the calendar "Canes Home Games" (7); the calendar name should also update in your list of calendars (8):
Google calendar UI, image shows the settings of the newly created calendar after it has been renamed
Settings updated after calendar renaming

If you go back to the home page of your calendar (https://calendar.google.com), you should now see the new calendar in your list (9) and any games in your events (10):
Google calendar UI, the list of events now contain games from the newly added calendar
Calendar and games have been successfully added

That's it! You have added the puckdex calendar to your Google account.

Enabling puckdex calendar on mobile devices
If you want to have this calendar as an option in your mobile devices, there is one extra step you need to do: you need to tell Google to sync this calendar to your devices.

First, navigate to https://calendar.google.com/calendar/u/0/syncselect; there, you should see a page where all your calendar appear with checkboxes next to them:
Google calendar UI, showing the list of calendars that are synced to mobile devices with a checkbox next to each of them to toggle it
Syncselect changes to access puckdex calendar on mobile devices

In this page, you will want to check the puckdex calendar (11) and save your changes (12). After doing this, you should be able to see your new calendar on all your devices.

Contribute and get help

Ideas? Issues and PRs are welcome at github.com/cbdm/puckdex

Need help? You can shoot us a message at [email protected]