By Bob Poláček, updated
Checked against Appetite UI 2.6 on
Calendar
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.
By Bob Poláček, updated
Checked against Appetite UI 2.6 on
On this page
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.
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.
Figma and code
Calendar is in the Appetite UI Figma library. Appetite UI Code does not have it yet.
Build it from the tokens: every stack of Appetite UI Code ships them with the names and values of the Figma file. Add your stack's package first: Install the code.
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; 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.
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 |
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.
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.
Default
Marked
Today
Active
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.
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.
The whole flow, with the sheets for a new event, its date and time and its guests, is on Calendar screens. The Month screen's grid is the Date Picker of 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) | The date pickers, docked or modal, show a month (Material 3) | 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.
Don't
Do not keep Time on a short event. The second line is cut in half and reads as a broken block.
Do
Show Now Indicator on today only, and only on a grid that shows today.
Don't
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 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.
See Calendar in the kit.
The read-only Figma preview opens the Appetite UI file on Calendar, so you can check it before you buy.
The file holds 599 variables in 6 collections and exports its token values to SwiftUI, Jetpack Compose, Flutter and CSS. Solo covers one person and Team up to ten people. You pay once and keep lifetime updates.