# Calendar app

Show events from any public ICS calendar feed — e.g. holidays, tournament schedules, course timetables, project milestones.

## Creating a Calendar app

1. Go to **Content > New > App** and search for the **Calendar** app.
2. Click the app to start creating a new app.
3. Enter an **app name**.
4. Enter the **Calendar URL** — a public `.ics` feed. Most calendar tools expose one per calendar; for example, Google Calendar provides a "secret iCal address" under calendar settings.
5. Pick a **Display mode** (see below).
6. Click **Create app**.

## Display modes

| Mode | What it shows |
|---|---|
| Weekly grid | A week as a grid of days and hours |
| Monthly grid | A full-month grid with events per day |
| Daily list | Today's events in a vertical list |
| Weekly list | This week's events in a list |
| Monthly list | This month's events in a list |
| Yearly | Full-year overview |
| Agenda | Chronological list of upcoming events |

::: tip Limit hours shown
For business-hours use cases, set a **from hour** and **to hour** to trim empty early/late slots out of the view.
:::

## All configuration options

| Setting | Explanation | Required |
|---|---|---|
| App name | A recognizable name shown in your content library | **Yes** |
| Calendar URL | Public ICS feed URL | **Yes** |
| Display mode | One of the modes listed above | **Yes** |
| Scroll list | Auto-scroll long lists vertically | No |
| Scroll pause (s) | Pause at the end of a scroll cycle | No |
| Scroll speed (px/s) | How fast the list scrolls | No |
| From hour / to hour | 24-hour range shown in grid modes | No |
| Hide top bar / day headers / sidebar / all-day events | Per-element visibility toggles | No |
| Colors | Up to 13 hex fields for event / header / border colors | No |