Module guide
Calendar
Year, month, week and day views with holidays and connected calendars.
Overview
Tasks with a due date render on the calendar alongside public holidays for your country and events pulled from connected Google and Microsoft calendars. A segmented control moves between year, month, week and day on a wide screen, and a mode toggle does the same on a narrow one. The view you choose is part of the address, so a week can be sent to somebody, a day can be bookmarked, and a refresh brings back what you were looking at.
Highlights
The capabilities worth knowing before you dive in.
Important to know
Limits, permissions, and sharp edges to keep in mind.
- Holidays are fetched for every year the grid shows, which is why a January view lists the previous December's holidays. The public feed answers for the years 1970 to 2100.
- Week start is worked out from the weekend days in your Calendar settings, because there is no separate week-start setting. The week starts on the day after the weekend ends: Monday for a Saturday and Sunday weekend, Sunday for a Friday and Saturday weekend, and the day after it for a one-day weekend.
- Holiday lookup is stored per country and year. Changing the workspace country in Settings and then Calendar refreshes it on the next page load.
- OAuth refresh tokens live in encrypted storage. Disconnect from Settings and then Calendar when a user leaves.
- Dragging an unscheduled task on to a time slot is done on the week planner at /calendar/week, which is a separate screen from the week view here.
How to use it
The primary workflow, start to finish.
- Move between year, month, week and day with the segmented control on a wide screen, or the mode toggle on a narrow one. Copy the address afterwards to share the view you are looking at.
- Use the arrow buttons to move one unit at a time, and Today to come back.
- Set your country in Settings and then Calendar so holidays appear.
- Add a Google or Microsoft calendar from Connect Google Calendar on this screen, or from Settings and then Calendar. Both start the same flow.
- To put a single task on your connected calendar, open the task and use Sync to calendar in its detail panel.
- To drag unscheduled work on to a time slot, open the week planner at /calendar/week.
- To move a scheduled task without dragging it, open the week planner at /calendar/week, press Tab until the task is focused, and use the arrow keys: Up and Down move it by one grid step, Left and Right by one day, and Shift with Up or Down changes its length. Press Enter to save the move or Escape to cancel it. The Grid step control sets the size of each step.
FAQ
- Can I send somebody a link to a particular week?
- Yes. The view is part of the address, so copying the address bar while you are on a week sends that week. The same is true of the day, month and year views.
- Why are no holidays showing for my country?
- A built-in catalogue covers India and Singapore, because the upstream feed has gaps there. Every other country is served from that public feed. If the feed cannot be reached the calendar still renders, without holidays, and shows a load failure notice with a Retry button.
- Why does an all-day event show no time?
- Because it has none. An all-day event from Google or Microsoft covers whole days rather than a moment, so it is listed as All day, and it appears on every day it spans rather than only the first.
- Why do my Google events not show up?
- First make sure the account is listed in Settings and then Calendar. Atlas renews the access token itself. If the provider has withdrawn access, disconnect the account there and connect it again. Events for the visible window are fetched when you open the calendar or move to a different range, so refresh to pull the latest.
- Why does my week start on the wrong day?
- Week start is worked out from the weekend days you choose in Settings and then Calendar, because there is no separate setting. The week starts on the day after the weekend ends: Monday for a Saturday and Sunday weekend, Sunday for a Friday and Saturday weekend, and the day after it for a one-day weekend. Change the weekend days if the week starts on the wrong day.
- How do I stop a departing colleague's calendar syncing?
- Disconnect the account from Settings and then Calendar. Refresh tokens are held in encrypted storage, and disconnecting is what removes the grant, rather than deleting the person's Atlas account.
- Can I reschedule a task without dragging it?
- Yes. On the week planner at /calendar/week, focus a task and use the arrow keys to move it, then press Enter to save or Escape to cancel. Leaving the task also saves the move. Each new time is read out to a screen reader, and a move that cannot be saved is announced and the task returns to where it was.
Automate this module