User guide

Getting started

Download Detent from the App Store and open it. There's no account to make and nothing to set up.

The first time you open it, Detent asks whether you'd like to share usage and crash reports with us. Either answer is fine — see Privacy.

Detent has three tabs:

  • Tasks — what's slipped, what's due today, and what's coming up
  • Schedule — a month calendar
  • More — your Ideas, Metrics and Settings

The one rule

Everything you need to do has a date. Anything without a date is an idea, and lives in More › Ideas until you decide to do it.


Adding a task

Tap + on the Tasks tab, type what you need to do, and save. The task is scheduled for today unless you say otherwise.

Dates as you type

Write the date into the title and Detent picks it out: "Call the dentist friday morning" is saved as "Call the dentist", on Friday, in the morning. A chip shows what Detent found; tap it if it got it wrong, and the title is left alone. A date you pick by hand always wins.

Detent understands things like "friday", "next tuesday", "3 march", "5/11" (5 November — dates are read day first), "in 2 weeks", "tomorrow", and times of day: "morning", "midday", "lunch", "afternoon", "evening", "night", or a time like "3pm". It never picks a date in the past: "friday" on a Friday means today.

Times of day

Tasks can sit in morning, midday, afternoon or evening, or have no time at all. That sets their order in the day, and when a strict task reminds you. Detent doesn't do exact times.

Tags

Type #home or #work in the title and it becomes a tag (and leaves the title). You can also add and remove tags in the tags field. Tags are used to search and in Metrics.

Everything else

The add sheet can also set notes, a hard deadline, strict timing and how a task repeats — everything you can change later.

Ideas

Switch the add sheet to Idea for something with no date. Ideas never appear in your lists, never remind you and are never overdue. To do one, open More › Ideas and tap Today, or give it a date in its details.


Your day

The Tasks tab opens on Today:

  • Overdue at the top: anything from an earlier day you haven't dealt with. Strict tasks come first, in red.
  • Then today: in time-of-day order, with what you've done struck through and a progress bar.

Upcoming shows the next two weeks, a day at a time. Pull down on either to refresh.

Each task has three buttons:

  • Done — finished. It stays on today's list, struck through.
  • Skip — not happening. It stops asking for attention. Skipping a one-off task finishes with it altogether, so Detent asks first.
  • Bump — not today. See below.

Nothing is ever dropped quietly: a task stays overdue until you do it, skip it or bump it.


Bumping

Bump moves a task out of today without you choosing a new date. Each bump of the same task goes further:

Bump Moves it
1st 1 day
2nd 2 days
3rd 4 days
4th 7 days
5th 14 days
6th 30 days
7th and later 60 days

The gap is counted from today, or from the task's date if that's later. The card shows how many times a task has been bumped.

Two things stop a bump going too far:

  • A hard deadline. A task can't be bumped past it, and bumps get shorter as it gets close (a quarter of the time left, at least a day). Once the deadline arrives, a one-off task can't be bumped, and a repeating task's Bump skips it.
  • The next occurrence, for repeating tasks. A bump can't land on or past the next one. For a daily task that means Bump does the same as Skip.

Repeating tasks

Turn on Repeats to have a task come round every so many days, weeks or months. Each occurrence can be done, skipped or bumped on its own.

Choose how the dates are worked out:

  • Repeat on schedule — the dates stay fixed, however late you are. Bins every Tuesday stay on Tuesdays. Monthly tasks keep their day of the month (on the 31st, short months use their last day).
  • Repeat after last done — the next one is counted from when you actually did it. A haircut every two months, done two weeks late, is next due two months after that.

Detent schedules repeating tasks about three months ahead, so they show up in Upcoming and the calendar.

Auto-skip if overdue

For routines where a missed one doesn't matter — watering the plants, checking the post — turn on Auto-skip if overdue. Once its day has passed, an occurrence you didn't get to is skipped automatically.

Even without it, a repeating task never stacks up: only its most recent overdue occurrence stays on your list.

Rotating variants

Turn on Rotating and give a repeating task a list of variants — say Push, Pull, Legs. Each occurrence shows whose turn it is. The rotation only moves on when you complete one, so if you skip Push, the next occurrence is Push again.


Strict timing

Most tasks just need doing sometime on their day. Mark the ones that really can't slide as Strict timing:

  • they remind you at the start of their time of day — 8am morning, 12pm midday, 3pm afternoon, 7pm evening — or at 8am if they don't have one;
  • they're marked as strict on their card and the widget;
  • if they're overdue, they go to the top of the list, in red;
  • the daily summary counts them as "critical".

Reminders

Detent only interrupts when it matters. Each kind can be switched off under More › Settings › Notifications:

  • Strict timing reminders (on) — see Strict timing.
  • Deadline warnings (on) — at 9am two days before a task's hard deadline, once.
  • End-of-day alerts (on) — at 9pm, for each task due that day that isn't done.
  • Daily summary (off) — at a time you choose, how many tasks are overdue, due today, and critical. It isn't sent when there's nothing due or overdue; if Detent couldn't work out the day's counts in advance, it just says "Here's your day".

Done and skipped tasks, ideas and archived tasks never remind you. Bumping a task moves its reminders to its new date. Tapping a task's reminder opens the task; tapping the daily summary opens Today.

Reminders are set up on your phone and work with no account or connection. Detent asks for notification permission the first time you save a task. If you said no, turn notifications on for Detent in your iPhone's Settings.


The widget

Add the Detent widget to your home screen (touch and hold the home screen, tap + or Edit › Add Widget, and choose Detent). It comes in small (two tasks) and medium (five tasks), and shows what's overdue and due today, in the same order as the app.

  • Tap the checkbox next to a task to mark it done without opening the app (iOS 17 and later).
  • Tap anywhere else to open Detent on Today.

The widget moves to the new day on its own at midnight, even if you haven't opened the app.


Changing and finishing tasks

Tap a task to see its details. Changes save as you make them. Changing a repeating task's settings updates its upcoming occurrences; anything already done or skipped stays as it was.

A few things are fixed:

  • A task can't be switched between one-off and repeating. Make a new one instead.
  • Once a one-off task is done, its date can't be changed.
  • To turn a one-off task back into an idea, remove its date.

Archiving

Archive puts a task away for good: nothing more is scheduled, anything pending is skipped, and its history stays in Metrics. It can't be undone. Archived tasks can be found in More › Settings › All tasks with Show archived on.

Deleting

For a task that should never have existed, archive it first, then open it and choose Delete permanently. That removes it and its history from the app and from Metrics, on every synced device, and erases what you wrote in it.


Finding tasks

More › Settings › All tasks lists every task: repeating, one-off, ideas and done. Search by title or tag.

The Schedule tab shows a month at a time, up to about three months ahead. Things that repeat every day or two are your routine, so a day with only those gets a hollow dot. Anything else (one-offs, weekly or monthly tasks) gets a filled dot each, up to three, so the days that stand out are the ones with something unusual on. Tap a day to see its week underneath. + on the Schedule tab adds a task on the selected day.


Metrics

More › Metrics shows the last 30 days: how many tasks you did, skipped, and left overdue, how many were bumped, and your completion rate, overall and for each tag. Skipped and overdue tasks both count as not done.


Sync between devices

Detent doesn't need an account. If you use it on more than one iPhone or iPad, sign in to keep them the same: More › Settings › Sign in. Your sign-in is an Achery account, shared with other Achery apps; if you already have one, use it.

  • Tasks already on the device are added to your account when you sign in.
  • Detent syncs when it opens, when you pull to refresh, and in the background. Sync now in Settings syncs straight away.
  • If a sync fails, a banner offers Retry. Your changes stay on your device until a sync succeeds.
  • If the same task was changed on two devices, the most recent change wins.

Signing out syncs first, then removes your tasks from that device (your account keeps them). If anything couldn't be synced, Detent warns you before it's lost. Your settings stay on the device.

Deleting your account

More › Settings › Delete account… permanently deletes your account and everything synced to it — every task and its history — from our server and from that device. It can't be undone. If you use Detent on other devices, sign out of them first.

Your Achery sign-in isn't deleted, because other Achery apps use it. To delete it too, email [email protected], as Your Achery account explains.


Settings

Under More › Settings:

  • Account and Sync — see Sync between devices and Deleting your account.

  • All tasks — see Finding tasks.

  • Notifications — see Reminders.

  • Colour scheme — Light, Dark, or System (follows your iPhone). The widget follows it too.

  • Share usage and crash data — see Privacy.

  • Background task log — every time Detent refreshed itself, and whether anything went wrong. Handy if you're reporting a problem.

  • Version — and a button to check for updates. Updates download in the background and apply the next time you open Detent; if you know a fix is out, you can fetch it here.


Privacy

Without an account, nothing you write in Detent leaves your phone. With one, your tasks sync to your own account on our server.

Share usage and crash data sends reports about how the app is used and when it crashes, to help find bugs. They never include task titles, notes or tags; if you're signed in, they're linked to your account ID, never your email or name. Sharing is off unless you said yes, and you can change it any time.

The privacy policy has the details.


Getting help

See the support page, or email [email protected].