GuideiPhoneiPhone
Widgets and controls
Eleven widgets, five controls, and a Live Activity that keep Kept within reach without opening it.
Most of what Kept does can be read or done from the Home Screen, the Lock Screen, or Control Center. The app becomes the place you go for the longer look.
Widgets never touch the network. They read a small snapshot the app leaves for them, and when you complete something on a widget the change is queued and lands the next time the app wakes. No widget or control carries a key of any kind. Kept schedules a background app refresh shortly after the day changes, then writes a new snapshot and reloads every widget.
Add a widget
Touch and hold the Home Screen, tap Edit, then Add Widget, and find Kept. Capture comes first in Kept's widgets, then Today and Todos, so the one-tap capture is the first thing you see. Widgets you have already placed stay as they are. Long-press a placed widget and choose Edit Widget for its options.
Once Today has shown the day's three in the app, the Today widget and its Top 3 show the same three, in the same order, even after Kept restarts. Before Today has opened that day, the widget shows your plan as it stands.
| Widget | Sizes | What it shows |
|---|---|---|
| Next | Small, Lock Screen | What matters next, with its time or its due day, on as many lines as its title needs. A task due today carries its complete button at every text size. Quiet when you are clear. |
| Today | Small to extra large, Lock Screen | What's next and your three. Medium and large let you check off your three, quick wins and habits in place, and large lists the day's events. On the Lock Screen: progress on your three, the next event, and the one thing next. |
| Habits | Small to large, Lock Screen | Today's habits, checkable in place. The ring moves without opening the app. With no habits open today it says No habits today and offers Add habit, never All kept today. On the Lock Screen no word is cut at any text size: the next habit ends on a whole word, what does not fit leaves, and the bar stays. |
| Agenda | Medium, large, Lock Screen | Today's events and due tasks in time order, with an area filter. The header counts each by its own name: 1 event · 2 due. |
| Calendar | Medium, large | Today's events and your next free stretch. Large draws the events by the hour; an event that has ended keeps its outline and lets its colour go, with its name still easy to read. |
| Focus | Small, medium, Lock Screen | Your focus level, today's minutes, and the week's minutes against your weekly goal, as a bar with its words (150 of 600 min this week). Small keeps one Start button, and at the largest text sizes it keeps Focus and Start whole by letting the week line and then its other lines go; medium adds up to three deep-work picks and names what Start aims at. Start, pause and stop a session. |
| Trends | Medium, large | A trend you choose, one non-Body metric's line, with its goal line when it has one. Large adds a second trend beneath it when you have one; otherwise the one line takes the whole tile. |
| Identity | Small, Lock Screen | Today's promises, and your identity statement once you have written one; until then, the week's kept days. |
| Tasks | Medium, large | Open tasks or your Top 3, complete one in a tap, with the row detail you choose. Top 3 rows are in order with no rank numbers, drawn or spoken. Every title sits at one size and uses its row's full width; only a title longer than its row ends in an ellipsis, after a whole word, rather than shrinking. Medium shows five tasks, each a ring and its title on one line, under a slim header: the list's name, how many are open (Open tasks 123), and a round + that adds a task. At the largest text sizes the list shows fewer rows (two on medium) so titles, undo and the header stay whole. |
| Capture | Small, Lock Screen | Three captures in one tap: note, task, and event. |
| Quick capture | Medium | Four buttons you choose: note, task, event or capture. |
Completing on a widget shows a short kept · undo chip for a few seconds, so a stray tap can be reversed; it clears on its own when the seconds are up, without opening Kept. Where a row is narrow, such as the Top 3 column of the medium Today widget, the chip reads undo alone and is never cut short. VoiceOver names the chip for what it does and what it undoes, Undo, Renew car registration kept, so it is findable with hints turned off. If iOS has not yet granted the background refresh, the widget moves the last good snapshot into the current day itself: still-open tasks remain, daily habits and totals reset, and a quiet as of yesterday stamp says what has not been freshly confirmed. It never asks you to open Kept just to make the date current.
What the Today widget shows, size by size
Every size opens with the date on one line, Wednesday, September 30, and a round + at the right that opens Capture. Each size answers one question at a glance.
- Small shows what's next and which of your three are open. The next event's time and name sit on one line under the date, and your three fill the rest of the tile, each beside a small dot that fills when you keep it (a dot, not a checkbox, because small does not check things off). With only one or two picked, the last one may use the room under it, so a long title still reads whole. Two of your three that start with the same words keep the words that tell them apart, Confirm… venue and Confirm… catering, rather than reading the same. With no event left today it names your next habit, marked Habit; with nothing left at all it shows tomorrow's first event. Small lists your three, not quick wins, unless no three are picked yet. Small is a preview: tap it to open Today.
- Medium lets you finish your three. They sit on the left; tap anywhere on a row to keep it, and the square fills. On the right, Up next shows the next event's start in large type, its name, in 40 min once it is within the hour, and the event after it. The header shows your habits as dots: filled for kept, a heavier ring for the next one.
- Large is your day. A panel at the top lists the next event and up to two more, with +1 more today when there are others. When nothing is left today it reads Tomorrow, with tomorrow's first start in large type and the event's name (and tomorrow's later events if there is room); with nothing tomorrow either, it is one quiet line, Up next Nothing scheduled. Below it, Top 3 and Quick wins sit side by side on the same lines, or, on a lighter day when they fit, one above the other so every title takes one line. Then your habits as rings, two to a row; when not all of them fit, +2 more › sits at the right of the Habits heading and opens Habits. Tap any task, quick win, or habit to keep it in place. When captures are waiting, File 3 captures appears at the top.
Every row in large keeps the same spacing whatever your day holds: a one-line row is always the same height, and a title that wraps adds a line. Room left over is never spread between rows. It goes to things worth reading first (the rest of a title, tomorrow's later events, a seventh and eighth habit), then to a little more space between sections, and the rest stays below the last row. On a full day, large gives things back in a fixed order before any row gets tighter: a quick win's second line, then a habit's, then the third line of one of your three, then two habits, then a later event.
- Lock Screen. The circle shows three arcs, one for each of your three, thick once kept, around the next event's start. The rectangle shows the next event and the first two of your three still open. Inline shows the one thing next: an event starting within three hours, else the first open of your three, else your next habit, else tomorrow's first event.
Tasks are squares and habits are rings, so the two read differently even on a tinted Home Screen. Something you keep stays where it was, struck through, with kept · undo beside it for a few seconds; a quick win then leaves and the next one takes its place. Your three stay all day, struck, once kept.
Before 4:00 PM, a day without three picked shows Choose your three › where they go, with two quick wins. From 4:00 PM that space shows the habits still open instead. In the evening, when no events or tasks are left, large turns to tomorrow: its first event, Pick tomorrow's three › (it opens Today for now), and every habit with its time of day.
Titles take up to two lines (one of your three may take three on large) and end on a whole word with a small tail, never inside a word and never after a stray separator: Design review…, not Design review ·…. A number stays on the line with the word it counts: due in / 4 days. Times are never cut, and a time shows its AM or PM once. The widget follows your 12 or 24-hour setting. With a larger text size, the widget shows fewer things before it shrinks anything: quick wins leave first, then the later events, then rows of your three.
Taps go where they say. A row keeps or undoes its item, an event opens that event, +N more today opens the calendar, the habit dots open Habits, and + opens Capture. Anywhere else on the Today widget opens Today, and anywhere else on the Tasks widget, its header included, opens Tasks. Every widget shows a title exactly as you wrote it: "Board the 11:05 train" is never rewritten as a clock time.
When a widget's information is more than four hours old, an as of 11:18 AM stamp appears in its top row, beside the heading or the date (on Today, just before the +), where it cannot cover anything. The morning after a night the app did not run, it reads as of yesterday in the same place. Where a widget has no heading row, the stamp sits in the bottom corner and the words beside it make room for it.
Body pause in 1.8.6: The Body widget, meal choices in Capture widgets, Body-derived Trends series, and meal controls are not registered. Existing meal intents open Today and are hidden from Shortcuts. Kept keeps the implementation and saved data for a future Body return.
Controls
Add Kept controls to Control Center or the Lock Screen from the controls gallery. There are five while Body is paused: Capture, Quick note, Add task, Complete next habit, and Start focus. Start focus also stops a running session, and it works from the locked screen; Complete next habit asks you to unlock first.
The Action Button
On an iPhone with an Action Button, open Settings › Action Button, choose Controls, and pick Capture. One press, the Capture sheet. Or choose Shortcut and pick Capture in Kept. Without an Action Button, give Capture in Kept to Back Tap in the Shortcuts app.
Live Activity
Start a focus session and it appears on the Lock Screen and in the Dynamic Island: Focusing or Paused, the countdown, and Pause and Stop that work without opening the app. On the Lock Screen it is a navy card with light type, readable on a light or dark wallpaper.
Home Screen quick actions
Touch and hold the Kept icon for Capture and Start focus, plus one that changes with your day: Resume focus when a session is paused, Complete next with the next habit's name, or Next with your next event. Log a meal appears only when meals are part of Kept and turned on, and it leaves the menu as soon as they are turned off.
Focus filters
In iOS Settings → Focus, add Set Kept Focus to a Focus such as Work and choose the life areas that belong to it. While that Focus is on, Today's calendar, the agenda, open tasks, and your widgets scope to those areas, and you can ask it to surface deep-work picks first. The free-window math still uses every event, so Free until 3 stays true.
Spotlight and Visual Intelligence
Tasks, notes, events, and goals are indexed for Spotlight; search from the Home Screen and open them directly. With Visual Intelligence, point the camera at a plate and Kept offers Log this meal in Kept; point it at anything else and it offers Capture in Kept. Labels only; the picture never leaves the device from that path.