---
title: Calendar
description: Calendar in Appetite UI for Figma: Calendar Event, Time Grid, Week Strip and Now Indicator, the parts of a day, week or agenda view on iOS and Android.
group: Components
source: https://www.appetiteui.com/docs/calendar
dateModified: 2026-11-20
verified: 2026-11-19
---

# Calendar

Updated: November 20, 2026.
Checked against Appetite UI 2.6 on November 19, 2026.

Calendar is the Appetite UI page of four parts that lay out a schedule: Calendar Event, Time Grid, Week Strip and Now Indicator. Use them for a day, week or agenda view of timed events, and Picker to choose a date. On Day an hour is 64 tall, on Week 52.

## Preview

Week Strip over Time Grid, with the events of week 46 and the now line at 09:41, as the Calendar screens set them. Pick a day in the strip: the day under it changes. View switches Day, Week and Agenda, and the events take Block, Compact and Row with it.

Specimen: Week 46, Thursday 12. Week Strip 345 x 70 over Time Grid 345 x 776.

Color recolours the lead event, Design review, through the eleven calendar colours of Calendar Event. The grid scrolls from 08:00 to 20:00 in its window, and the arrow keys move the picked day once the strip has the focus.

Source: the Calendar page and the Day, Week and Agenda screens of the Appetite UI 2.6 Figma file, read on November 19, 2026.

## How do the calendar parts fit together?

In three layers under one strip: Time Grid at the bottom, Calendar Event blocks over it, Now Indicator on top, and Week Strip above the grid to move between days.

The Day and Week screens stack them the same way. The grid carries no events of its own; the events sit on it by start and end, and the now line by the current minute. Week Strip lines up with the grid: on Day it spans the full 345, on Week it narrows to the 301 of the seven columns and drops its marks.

| Part | What it does | Use it when |
| --- | --- | --- |
| `Calendar Event` | One event, as a Block, a Compact block or a Row | A screen lists or places timed events |
| `Time Grid` | The hour scale, Day or Week | Time of day matters: a day or a week view |
| `Week Strip` | Seven days in one row, one picked | The reader moves a day or week view one day at a time |
| `Now Indicator` | The current minute across the grid | The grid shows today |

Layout follows the view, as the file's section header says: Block on Day at 64 per hour, Compact on Week at 52, Row in the Agenda list. To choose a date across a month, use [Picker](https://www.appetiteui.com/docs/picker); Week Strip moves a view inside the week on screen.

## Calendar Event

Calendar Event is one event on a calendar: a block on a day grid, a narrow block on a week grid, or a row in an agenda list.

Specimen: Calendar Event, Block. Block 160 x 56, radius 8, edge 3.

Every layout carries the colour of its calendar twice: the fill and the edge on Block and Compact, the bar on Row. Block prints the title on up to two lines and the time on one; Compact gives the title three lines in a column 56 wide; Row prints the start and end in a 48 column, the bar, the title and a detail line such as the room.

| Layout | View | What it shows |
| --- | --- | --- |
| `Block` | Day, on Time Grid at 64 per hour | Title and time in a tinted block with a coloured edge, as tall as the event is long |
| `Compact` | Week, in columns 43 wide | The title, cut to the column; the Week screen turns Time off |
| `Row` | Agenda list | Start and end, a coloured bar, the title and a detail line |

Specimen: Color, Block. Block 160 x 56, radius 8, edge 3.

Hide Time on events of 30 minutes or less, where the second line no longer fits: the Day screen draws Release 2.6 sync, 14:00 to 14:30, with its title alone. Two events that overlap on Day split the column with 4 between them; on Week they stack in their column, the later one on top.

## Time Grid

Time Grid is the hour scale behind a day or week view. Calendar Event blocks sit on it, and Now Indicator marks the current minute.

Specimen: Time Grid, View Day. 345 x 776, an hour 64 tall.

Each hour is a nested _Time Row whose label sits on its top hairline, in a gutter 44 wide. Day draws one column at 64 per hour, 345 x 776 for the twelve hours from 08:00; Week draws seven columns 43 wide at 52 per hour, 345 x 632, and tints Saturday and Sunday. Rename the labels when the day starts at another hour.

The _Time Row description says the label sits in a 48 gutter; the rows draw the cells 44 in, and Now Indicator's time pill is 44 wide. The stage draws what the rows draw.

## Week Strip

Week Strip is seven days in one row, for moving between days in a day or week view.

Specimen: Week Strip. 345 x 70, seven equal days.

Pick a day in the strip above: the tap makes it Active in 200 ms on motion/easing/standard, as the file's prototype runs it. The days share the width equally, so the strip lines up with a seven column Time Grid under it.

| State | When | Look |
| --- | --- | --- |
| `Active` | The picked day, exactly one | A brand/base pill with the weekday, date and mark in white |
| `Today` | Today, while another day is picked | Weekday and date in brand/base, no pill |
| `Default` | Every other day | Weekday in text/soft-500, date in text/strong-950 |
| `Marked` | A day with events, in any state | A 6 dot under the date |

A marked day is 70 tall and an unmarked one 60, and the strip aligns its days to the top, so a mark never moves the date. The component marks its first three days; the Day and Agenda screens mark all seven, because every day of week 46 has an event.

## Now Indicator

Now Indicator is the line that marks the current minute across every column of a Time Grid, with the time in the gutter.

Specimen: Now Indicator, 09:41. 345 x 16, time pill 44 wide.

It is the top layer of a calendar view, over the grid and the events. Its place is the minute: on Day at 64 per hour, 09:41 sits 107.7 under the 08:00 line, 101 minutes at 64 per 60. Show it on today only; on Day the screens draw it on Thursday 12 and nowhere else, on Week across all seven columns.

## Where do the calendar parts appear in the Calendar screens?

Day and Week stack all four parts, Agenda lists Rows under its day heads, and Month lists the picked day's Rows under its grid. Event is what a tap on an event opens.

![Calendar app Day screen: Thursday 12 November with a week strip, Design review, Lunch with Noemi, Prototype testing and Release 2.6 sync on an hour grid, and a red now line at 09:41](https://www.appetiteui.com/images/au_calendar_day_light.webp)

Day: Week Strip, Time Grid, Block, Now Indicator

![Calendar app Week screen: Week 46 as seven day columns on an hour grid, colored event blocks such as Sync, Plan, Gym and Long run, and a red now line at 09:41](https://www.appetiteui.com/images/au_calendar_week_light.webp)

Week: Week Strip, Time Grid, Compact, Now Indicator

![Calendar app Agenda screen: the next seven days as a list grouped by Today, Tomorrow and Saturday, each event with its start and end time, a colored bar, its title and place](https://www.appetiteui.com/images/au_calendar_agenda_light.webp)

Agenda: Row

![Calendar app Month screen: November with a Day, Week and Month switch, a month grid with event dots and the 12th selected, the events of Thursday 12 November as rows below, and a floating add button above the tab bar](https://www.appetiteui.com/images/au_calendar_month_light.webp)

Month: Row under the month grid

![Calendar app Event screen: Design review with Work and Weekly badges, rows for when, where, repeat and alert, two attendees who accepted, and Decline, Maybe and Accept buttons](https://www.appetiteui.com/images/au_calendar_event_light.webp)

Event: what a tap on an event opens

The whole flow, with the sheets for a new event, its date and time and its guests, is on [Calendar screens](https://www.appetiteui.com/docs/screens-calendar). The Month screen's grid is the Date Picker of [Picker](https://www.appetiteui.com/docs/picker), not a calendar part.

## Properties

Calendar Event carries the texts as properties, so an event is never detached to rename it. The other parts set their days and hours on nested rows.

| Property | Type | Default |
| --- | --- | --- |
| `Color` | Brand \| Feature \| Success \| Warning \| Information \| Error \| Highlighted \| Stable \| Verified \| Away \| Faded | Brand |
| `Layout` | Block \| Compact \| Row | Block |
| `Title` | Text | Design review |
| `Time` | Text, Block and Compact | 09:30 to 10:30 |
| `Show Title` | Boolean | true |
| `Show Time` | Boolean; on Row it hides Start and End | true |
| `Start` | Text, Row | 09:30 |
| `End` | Text, Row | 10:30 |
| `Detail` | Text, Row | Room 2 |

| Part | Property | Type | Default |
| --- | --- | --- | --- |
| `Time Grid` | `View` | Day \| Week | Day |
| `_Time Row`, in Time Grid | `Time` | Text | 08:00 |
| `_Week Day`, in Week Strip | `State` | Default \| Active \| Today | Default |
| `_Week Day`, in Week Strip | `Weekday`, `Date` | Text | M, 9 |
| `_Week Day`, in Week Strip | `Marked` | Boolean | false |
| `Now Indicator` | None; set the time on its label | | |

| Set | Variants | Size |
| --- | --- | --- |
| `Calendar Event` | 33, Color crossed with Layout | Block 160 x 56, Compact 56 x 64, Row 345 x 70 |
| `Time Grid` | 2, Day and Week | Day 345 x 776, Week 345 x 632 |
| `_Time Row` | 2, Day and Week | Day 345 x 64, Week 345 x 52 |
| `Week Strip` | One component | 345 x 70 |
| `_Week Day` | 3, one per State | 44 x 60 on its own, one seventh of the strip inside it |
| `Now Indicator` | One component | 345 x 16 |

## Tokens

Each calendar colour is a pair of state tokens, the lighter fill and the base edge, so a calendar keeps its colour in Light and Dark. The grid and the strip use the neutrals every component uses.

| Token | Light | Dark | Applied to |
| --- | --- | --- | --- |
| `brand/lighter` | #EFF6FF | #132150 | Brand event fill |
| `brand/base` | #155DFC | #2B7FFF | Brand edge and bar, Active day, Today's texts, the marks |
| `state/feature/lighter-50` | #EFEBFF | #7D52F4 at 16% | Feature event fill |
| `state/feature/base-500` | #7D52F4 | #693EE0 | Feature edge and bar |
| `state/success/lighter-50` | #F0FDF4 | #22C55E at 16% | Success event fill |
| `state/success/base-500` | #22C55E | #16A34A | Success edge and bar |
| `state/warning/lighter-50` | #FFF7ED | #FF6900 at 16% | Warning event fill |
| `state/warning/base-500` | #FF6900 | #F54900 | Warning edge and bar |
| `state/highlighted/base-500` | #FB4BA3 | #E9358F | Highlighted edge and bar, on #FFEBF4 or #FB4BA3 at 16% |
| `state/stable/base-500` | #22D3BB | #1DAF9C | Stable edge and bar, on #E4FBF8 or #22D3BB at 16% |
| `state/verified/base-500` | #47C2FF | #35ADE9 | Verified edge and bar, on #EBF8FF or #47C2FF at 16% |
| `state/away/base-500` | #FE9A00 | #E17100 | Away edge and bar, on #FFFBEB or #FE9A00 at 16% |
| `state/faded/base-500` | #8E8E93 | #636366 | Faded edge and bar, on #F4F5F5 or #6A7282 at 16% |
| `state/error/base-500` | #FB2C36 | #FB2C36 | Now Indicator; Error edge and bar, on #FEF2F2 or #FB2C36 at 16% |
| `fg/strong-950` | #0E0E0F | #FFFFFF | Event titles, Start, the date of a day |
| `fg/sub-700` | #48484A | #C7C7CC | Event time, Detail, the Agenda heads |
| `fg/soft-500` | #8E8E93 | #AEAEB2 | Hour labels, End, the weekday of a day |
| `text/on-color/strong` | #FFFFFF | #FFFFFF | Active day texts and mark, the now time |
| `border/soft-100` | #E9E9EA | #2F2F31 | Hour lines, column lines, the Agenda card and its dividers |
| `bg/weak-50` | #F4F5F5 | #242427 | Saturday and Sunday on Week |
| `bg/white-0` | #FFFFFF | #0E0E0F | The ground of the grid and the strip |

Information uses the brand pair in Light, #EFF6FF on #155DFC, and #2B7FFF at 16% in Dark.

## Is there a native calendar view on iOS or Material 3?

Not for a schedule. Neither iOS nor Material 3 ships a day or week view, an event block or a week strip, and the Apple and Material 3 pages of the file carry no calendar component; both platforms pick dates with a month calendar.

| Appetite UI | iOS | Material 3 | What differs |
| --- | --- | --- | --- |
| Calendar Event | None; EventKit gives the data and EventKitUI the event's detail sheet | None | Build each layout as a view placed by start and end, coloured by its calendar. |
| Time Grid, Now Indicator | None | None | A scroll view of hour rows with the events and the now line laid over it. |
| Week Strip | `UICalendarView` and the graphical `DatePicker` show a month ([iOS](https://www.appetiteui.com/docs/ios#ios-picker)) | The date pickers, docked or modal, show a month ([Material 3](https://www.appetiteui.com/docs/material-3#m3-picker)) | Week Strip keeps one week on screen and moves the view under it one day at a time. |

A day in Week Strip is 49 x 70 on Day, over the 44 pt of iOS and the 48 dp of Material 3; on Week it narrows to 43 x 60, so give each day a hit area of the full `platform/min-touch-target`.

## How do I make a calendar view accessible?

Name every event by its title, time and calendar, make the strip a group of radios named by full dates, and do not let colour or position carry what text should.

- **Touch target.** A day in Week Strip is 49 x 70 on Day and 43 x 60 on Week. A Block is as tall as its event: 30 for 30 minutes on Day, 14 for a 15 minute Compact on Week, so let a tap on a short event open the day's list, or reach 44 pt with a hit area into the free space under it.
- **Contrast.** Event titles and times read at 7.82 to 1 or more on every fill in Light, and 8.6 to 1 in Dark. The hour labels, End and the weekdays are fg/soft-500, 3.26 to 1 on white, so they repeat what the grid and the date already say. The now time is white on state/error/base-500 at 3.81 to 1, and the Active day's white texts on brand/base are 5.25 to 1 in Light but 3.76 to 1 in Dark. Edges as light as Stable, 1.89 to 1 on white, are why the calendar's name belongs in the event's name.
- **Role and name.** In code an event is a button named by its title, time and calendar, for example "Design review, 09:30 to 10:30, Work". Week Strip is a radio group named by the week, and each day a radio named by its full date, with "today" on today. Now Indicator is decoration apart from its time, read as "Now, 09:41".
- **Keyboard.** Week Strip is one tab stop, and the arrow keys move the picked day without wrapping past the week's ends, as the strip above does. Events take the focus in time order, and the grid's scroll area takes it too, so the hours after the window can be reached.
- **Reduced motion.** The only motion is the strip's 200 ms change of colour, which moves nothing. When a view opens scrolled to now, jump there rather than scroll under prefers-reduced-motion.

## How do I use the calendar parts well?

Let the view pick the layout, give short events their title alone, and keep the now line on today.

- Do: Turn Time off on an event of 30 minutes or less. On Day it is 30 tall, room for the title alone.

Specimen: Show Time off. Block 30 tall, 30 minutes on Day.

- Avoid: Do not keep Time on a short event. The second line is cut in half and reads as a broken block.

Specimen: Show Time on. Block 30 tall, 30 minutes on Day.

- Do: Show Now Indicator on today only, and only on a grid that shows today.

- Avoid: Do not draw the now line on another day. It points at a time that is not now.

Week Strip or Picker? Week Strip when the reader moves through the days of one week with the content of the day under it; [Picker](https://www.appetiteui.com/docs/picker) when the month matters, a date far ahead or a range. Block or Row? Block when the time of day is the point and the grid shows it; Row when the order matters more than the gaps, as in Agenda.

## Related components

The components a calendar screen is built with, and the ones to reach for when a calendar part is not the answer.

- [Picker](https://www.appetiteui.com/docs/picker): the Date Picker, for choosing a date or a range across a month.
- [Segmented Control](https://www.appetiteui.com/docs/segmented-control): the Day, Week and Month switch over the calendar views.
- [Floating Action Button](https://www.appetiteui.com/docs/button#fab): the add button over every calendar view.
- [Empty State](https://www.appetiteui.com/docs/alert#empty-state): a day with nothing planned, under the strip of the Empty day screen.
- [Calendar screens](https://www.appetiteui.com/docs/screens-calendar): the whole flow, from Month to the Conflict alert.

Source: the Calendar page of the Appetite UI 2.6 Figma file (18283:31964), Calendar Event 18162:1201, Time Grid 18200:1093, Week Strip 18177:912 and Now Indicator 18200:1094, read on November 19, 2026.
