Skip to content

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
  1. Preview
  2. Figma and code
  3. How the parts fit
  4. Calendar Event
  5. Time Grid
  6. Week Strip
  7. Now Indicator
  8. In the Calendar screens
  9. Properties
  10. Tokens
  11. iOS and Material 3
  12. Accessibility
  13. Guidelines
  14. Related components
  15. Get the file

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.

Week 46, Thursday 12Week Strip 345 x 70 over Time Grid 345 x 776
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
18:00
19:00
Sync09:00 to 10:00
Gym13:00 to 14:30
Plan10:00 to 12:00
Sync09:00 to 10:00
Call14:00 to 15:00
Design review09:30 to 10:30 · Room 2
Lunch with Noemi12:00 to 12:45 · Canteen
Prototype testing13:00 to 14:30
Release 2.6 sync
Now, 09:41
Stand-up
Team offsite11:00 to 13:30
Long run10:00 to 11:30
Yoga11:00 to 12:30
View

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.

Calendar parts, part, what it does, use it when
PartWhat it doesUse it when
Calendar EventOne event, as a Block, a Compact block or a RowA screen lists or places timed events
Time GridThe hour scale, Day or WeekTime of day matters: a day or a week view
Week StripSeven days in one row, one pickedThe reader moves a day or week view one day at a time
Now IndicatorThe current minute across the gridThe 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.

Calendar Event, BlockBlock 160 x 56, radius 8, edge 3
Design review09:30 to 10:30
Layout
Show Title
Show Time

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.

Calendar Event layouts, layout, view, what it shows
LayoutViewWhat it shows
BlockDay, on Time Grid at 64 per hourTitle and time in a tinted block with a coloured edge, as tall as the event is long
CompactWeek, in columns 43 wideThe title, cut to the column; the Week screen turns Time off
RowAgenda listStart and end, a coloured bar, the title and a detail line
Color, BlockBlock 160 x 56, radius 8, edge 3
Brand09:30 to 10:30
Feature09:30 to 10:30
Success09:30 to 10:30
Warning09:30 to 10:30
Information09:30 to 10:30
Error09:30 to 10:30
Highlighted09:30 to 10:30
Stable09:30 to 10:30
Verified09:30 to 10:30
Away09:30 to 10:30
Faded09:30 to 10:30

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.

Time Grid, View Day345 x 776, an hour 64 tall
08:00
09:00
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
18:00
19:00
View

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.

Week Strip345 x 70, seven equal days
W11

Default

W11

Marked

T12

Today

T12

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.

Week Strip day states, state, when, look
StateWhenLook
ActiveThe picked day, exactly oneA brand/base pill with the weekday, date and mark in white
TodayToday, while another day is pickedWeekday and date in brand/base, no pill
DefaultEvery other dayWeekday in text/soft-500, date in text/strong-950
MarkedA day with events, in any stateA 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.

Now Indicator, 09:41345 x 16, time pill 44 wide
09:00
10:00
Now, 09:41

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.

Day: Week Strip, Time Grid, Block, Now Indicator
Week: Week Strip, Time Grid, Compact, Now Indicator
Agenda: Row
Month: Row under the month grid
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. 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.

Calendar Event properties, property, type, default
PropertyTypeDefault
ColorBrand, Feature, Success, Warning, Information, Error, Highlighted, Stable, Verified, Away, FadedBrand
LayoutBlock, Compact, RowBlock
TitleTextDesign review
TimeText, Block and Compact09:30 to 10:30
Show TitleBooleantrue
Show TimeBoolean; on Row it hides Start and Endtrue
StartText, Row09:30
EndText, Row10:30
DetailText, RowRoom 2
Properties of the other parts, part, property, type, default
PartPropertyTypeDefault
Time GridViewDay | WeekDay
_Time Row, in Time GridTimeText08:00
_Week Day, in Week StripStateDefault | Active | TodayDefault
_Week Day, in Week StripWeekday, DateTextM, 9
_Week Day, in Week StripMarkedBooleanfalse
Now IndicatorNone; set the time on its label
Calendar sets, set, variants, size
SetVariantsSize
Calendar Event33, Color crossed with LayoutBlock 160 x 56, Compact 56 x 64, Row 345 x 70
Time Grid2, Day and WeekDay 345 x 776, Week 345 x 632
_Time Row2, Day and WeekDay 345 x 64, Week 345 x 52
Week StripOne component345 x 70
_Week Day3, one per State44 x 60 on its own, one seventh of the strip inside it
Now IndicatorOne component345 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.

Tokens, token, light, dark, applied to
TokenLightDarkApplied to
brand/lighter#EFF6FF#132150Brand event fill
brand/base#155DFC#2B7FFFBrand 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#693EE0Feature edge and bar
state/success/lighter-50#F0FDF4#22C55E at 16%Success event fill
state/success/base-500#22C55E#16A34ASuccess edge and bar
state/warning/lighter-50#FFF7ED#FF6900 at 16%Warning event fill
state/warning/base-500#FF6900#F54900Warning edge and bar
state/highlighted/base-500#FB4BA3#E9358FHighlighted edge and bar, on #FFEBF4 or #FB4BA3 at 16%
state/stable/base-500#22D3BB#1DAF9CStable edge and bar, on #E4FBF8 or #22D3BB at 16%
state/verified/base-500#47C2FF#35ADE9Verified edge and bar, on #EBF8FF or #47C2FF at 16%
state/away/base-500#FE9A00#E17100Away edge and bar, on #FFFBEB or #FE9A00 at 16%
state/faded/base-500#8E8E93#636366Faded edge and bar, on #F4F5F5 or #6A7282 at 16%
state/error/base-500#FB2C36#FB2C36Now Indicator; Error edge and bar, on #FEF2F2 or #FB2C36 at 16%
fg/strong-950#0E0E0F#FFFFFFEvent titles, Start, the date of a day
fg/sub-700#48484A#C7C7CCEvent time, Detail, the Agenda heads
fg/soft-500#8E8E93#AEAEB2Hour labels, End, the weekday of a day
text/on-color/strong#FFFFFF#FFFFFFActive day texts and mark, the now time
border/soft-100#E9E9EA#2F2F31Hour lines, column lines, the Agenda card and its dividers
bg/weak-50#F4F5F5#242427Saturday and Sunday on Week
bg/white-0#FFFFFF#0E0E0FThe 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.

Calendar parts against iOS and Material 3, Appetite UI, iOS, Material 3, what differs
Appetite UIiOSMaterial 3What differs
Calendar EventNone; EventKit gives the data and EventKitUI the event's detail sheetNoneBuild each layout as a view placed by start and end, coloured by its calendar.
Time Grid, Now IndicatorNoneNoneA scroll view of hour rows with the events and the now line laid over it.
Week StripUICalendarView 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.

Show Time offBlock 30 tall, 30 minutes on Day
Release 2.6 sync

Don't

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

Show Time onBlock 30 tall, 30 minutes on Day
Release 2.6 sync14:00 to 14:30

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.