- Docs
- Getting started
Plan your day
Use the planner in a few minutes - the Today page, the calendar, the Inbox, repeating events, habits, reminders, meeting links, emoji icons and .ics import.
On this page
The planner turns your notes into a day you can see. ☀️ It has no database of its own: an event is an ordinary note with a few lines of frontmatter, so it stays readable in any editor.
Open it
- Today page: the sun in the ribbon on the left, or Open Today page in the command palette (Ctrl + P).
- Calendar: the calendar icon in the ribbon, or Open calendar.
The Today page greets you and shows the day at a glance: a timeline by hour, tasks that are due or overdue, today’s habits and your Inbox. Meetings get a Join button right on the timeline.
Make an event 📅
- Open the calendar and pick a view at the top right: Day, 2, 3 or 4 days, Week or Month. Phones start in the 3-day view and also have a List mode.
- Drag on an empty part of a day (or double-click it), type a title and press Enter. A single click never creates anything.
- The event is saved as a note in the
Eventsfolder. Drag the block to move it, drag its bottom edge to change the end. Everything snaps to 15 minutes. On a phone, press and hold before you drag.
Click a block to see its details: when it repeats, where it is, linked notes, subtasks and tags, plus Open note, Mark done for tasks and habits, and Join when it has a meeting link.
Keyboard: T jumps to today, the arrow keys move between days, Enter opens a block’s details and Alt + arrow keys move a block by 15 minutes or by a day.
Plan from the Inbox
Task notes without a date wait in the Inbox next to the calendar. Drag one onto a time, the all-day row or a day in Month view to plan it. On a phone, use the Schedule button on the task instead. Back to inbox in a task’s details takes its time away again.
What the note looks like
---
icon: 🚀
during: { start: 2026-11-02T09:30, end: 2026-11-02T09:45 }
repeat: weekdays
remind: 10m
meeting: https://video.example.com/standup
location: Room 4
---
Agenda in [[Weekly review]].
| Key | What it does |
|---|---|
during |
When it happens. Dates only make it an all-day event; a time without an end lasts an hour. |
due |
A deadline. A task with only due sits in the all-day row of that day. |
repeat |
daily, weekdays, mon, wed, every 2 weeks on mon, thu, monthly on 2nd tue, yearly, and more. Add until: and skip: to end a series or leave out days. |
remind |
10m, 1h, 1d before, at 09:00 on the day, or an exact 2026-11-04T08:00. A list is fine: [1d, 10m]. |
meeting |
The join link (https:// only). Without it, the first https:// link on a line starting with Join:, Meeting: or Link: is used. |
icon |
One emoji shown before the note’s title everywhere. |
Moving one event of a repeating series asks This event or All events. “This event” adds the day to skip: and
makes a separate note for the moved one, so nothing is lost.
Habits and streaks 🔥
Habits from your habit tracker show up on the days they are due. Tick one off on the Today page and the flame shows your streak. See Templates for the habit tracker.
Reminders
Add remind: to an event or task and Scaffold reminds you before it starts 🔔:
- Windows: a notification from the system, plus a card inside the app with Open and Snooze 10 min. Reminders are on by default on desktop.
- Android: reminders start switched off. Turn them on in Settings, Reminders; only then does Android ask for permission to show notifications. Reminders still arrive when the app is in the background or closed, and they come back after a restart of the phone. Android may deliver them a few minutes late.
- A reminder up to 15 minutes late still shows. Older ones (the computer was asleep, the app was closed) are grouped into one card: “You missed N reminders”.
Everything is worked out on your device from your notes. There is no push server, and snoozing writes nothing into the note.
Emoji icons
Right-click a note in the file list (or its tab) and choose Set icon…, or click the icon square in an event’s
details. Search, pick an emoji, done. It is stored as icon: in the note.
Import a calendar file
Run Import calendar file (.ics) from the command palette and choose a file you exported from another calendar. Scaffold
shows how many events it found, then writes one note per event into Events. Existing notes are never overwritten and
nothing is sent anywhere. A repeat rule Scaffold cannot read is not guessed: that event is imported once, with the rule
written into the note. Live two-way calendar sync is not part of Scaffold.