Guide

This is the long-form reference for everything in DONE(kinda). Skim the table of contents on the left for a specific feature, or read it top to bottom.

Getting started

The first time you open the app, a four-slide welcome appears: Welcome, To-do + Day + Week, Habit + Nook, and Meaningful. Tap through or skip to jump in. You can replay it any time from Settings → About → Replay onboarding.

The app is local. Nothing you do is sent to a server. If you want to back up or move to another phone, use Settings → Data → Export to grab a JSON file, then Import it on the other device.

The five tabs

The bottom tab bar has five surfaces. They share data; each one frames it differently.

• Day: today's schedule. Time-anchored events. Use this for "what's happening when".
• To-do: today's tasks. Things to do, no fixed time. Use this for "what needs doing".
• Week: a digest across seven days. Drag a to-do from one day to another. Skim before planning.
• Habits: your routines and the check-in grid for the past week.
• Nook: your save-for-later. Notes, links, podcasts, articles — anything you want to come back to.

Adding to-dos

Two ways to add a to-do.

From the To-do tab

Each bucket (Morning / Afternoon, or any custom buckets) has a faded + Add to-do line at the bottom. Tap it. The line expands into a full form: title input, plus a chip strip for tag, category, priority, meaningful, and pin. The reminder bell, deadline flag, and palette icon live in the action row. Tap Add when you're done.

From the floating button

The purple circle button in the bottom-right opens the Quick Capture sheet. Type a title and submit — or use natural language like buy bread tomorrow @health #shopping. See Quick capture for the full syntax.

Editing

Tap the chevron on a row to expand it. The expanded form mirrors the add form: title field, action row, optional notes timeline. Tap the chevron again to collapse. Edits save as you type; there's no Save button.

The status cycler

Every to-do row has a small squircle on the left. Tap it to advance the status. The cycle order:

• To do → In progress → Blocked → Done
• For recurring rows, Paused sits between Blocked and Done.

Each state has its own glyph. Done shows a check; in progress shows a partially-filled circle; blocked shows an X; paused shows two bars. Done strikes through the title. The colour stays the same: a strike means done, a dim means paused. The two channels never overlap.

Habits cycler

Habits use a smaller cycle: absent → paused → done → absent. No "blocked" state.

Swipes and gestures

Rows respond to four interactions. The hierarchy from most-deliberate to most-casual:

1. Drag handle (Week tab digest rows): long-press starts a drag, drop on another day to reschedule.
2. Long-press: opens the contextual action menu (where applicable).
3. Swipe: right swipe is a "forward" action (mark done, archive). Left swipe is the "undo" reverse.
4. Tap: chevron-only-toggle. Tapping the row body does nothing; only the chevron expands the row.

If you're left-handed, turn on Settings → General → Mirror swipes — right and left swap meanings.

The Day tab

The Day tab shows the timed schedule for the selected day. Use the date strip at the top to navigate (chevrons or the calendar caret).

Adding an event

Tap + Add event at the bottom of the timeline. A form appears with a time picker, title, and the same chip strip as a to-do (priority, category, tags, palette).

Up next banner

When today has an upcoming event, a small banner sits above the timeline showing what's next and how many minutes until it starts.

Recurring events

Toggle the recurrent icon when adding to make the event repeat. Daily, weekly with day picker, weekends, every-N-days, and annually are all supported. See Recurring for cascade rules.

The Week tab

The Week tab shows seven days of digests at once. Each day has its to-dos, events, and habits in a stacked card.

Drag-to-schedule

Long-press any digest to-do row. The card lifts; drag onto another day's card to move the to-do to that date. Quick taps still open the day; quick swipes still navigate weeks. The 120ms long-press is the gate that picks the gesture.

Drag-to-schedule moves to-dos only (not events or habits) and works across days but not within the same day.

Carousel cards

If your week has Achievements unlocked or a celebratory weekly wrap, those appear as cards above the day grid.

Habits

Habits are routines you check in on. Different cadence than a to-do: a habit is for "do this regularly", not "do this once".

Adding

Habits tab → + Add habit. Pick a cadence: daily, weekdays only, weekends only, weekly with specific days, every-N-days. Habits also accept a category, tags, priority, palette, and a note.

Checking in

Each habit row has the cycler. Tap to mark today's check. The grid at the top of the Habits tab shows the past week so you can see streaks at a glance.

Pausing

Cycle to Paused to halt a habit without deleting it. The row dims. Resume by cycling forward again.

Nook

The Nook is your save-for-later. Articles, links, podcasts, books, videos — anything you want to remember without it polluting your task list.

Adding

Nook tab → + Add note. Pick a type (note, link, article, book, podcast, video), give it a title, optional URL, optional body. The type drives the icon on the row.

Pinned scratchpad + daily note

The Nook also includes a permanent pinned scratchpad and a fresh daily note for the selected day. Both support the same body editor.

Meaningful

The star feature, literally. Star a to-do, event, habit, or thought as Meaningful and it lives in the carousel at the top of every day. A quiet reminder of what's behind the busy.

Marking as meaningful

Tap the star icon on the expanded row's action bar. Add a "why this matters" note — it'll surface in the carousel and the DONE(really) archive.

The carousel

One rotating line at the top of every tab when you have meaningful items. Tap the chevron to see the full list in a sheet.

DONE(really)

When a meaningful to-do is completed, a celebration overlay fires and the entry is added to the DONE(really) archive — your record of significant completions over time.

Recurring

Recurring to-dos and events generate instances on a cadence. The template is the source of truth; instances on each date inherit from it.

Cadence options

• Daily — every day
• Weekly — pick specific days (Mon, Wed, Fri, etc.)
• Weekends — Saturday and Sunday only
• Every N days — for cadences like every-3-days
• Annually — for birthdays / yearly events

Editing instances vs. the template

When you edit a recurring row, you're prompted: "This one / This and future / Whole series". Pick the scope. Some fields (title, category, tags) prompt you; others (colour) cascade silently; AM/PM and cadence are template-only.

Removing

The trash icon on a recurring row opens a delete-scope dialog with three options:

• Delete this — just today's instance
• Delete this and future — ends the series at today
• Delete whole series — wipes the template and every linked instance

Reminders

Each to-do can have a scheduled time and a reminder offset.

Setting a reminder

Tap the bell icon on the expanded to-do row. A popover opens with a stepper time picker (hour and minute, tap or type). Below that, the offset chips: At time, 5 min, 15 min, 30 min, 1 hour, 2 hours. Pick how long before the scheduled time you want to be reminded.

The popover hides offsets that would land in the past, so if you're scheduling for 5 minutes from now you won't see "30 min before".

Permission

The first time you schedule a reminder, Android prompts for notification permission. If you deny it, no reminder will fire until you enable it in system Settings → Apps → DONE(kinda) → Notifications.

Morning briefing

Settings → Notifications → Morning briefing: a daily nudge at the time of your choice. Useful as a "open the app and plan your day" anchor.

Quiet hours

If you don't want notifications during a window (say, 22:00 to 07:00), enable Quiet hours in Settings. Reminders that would land inside that window are suppressed.

Filters and saved views

The filter panel (filter icon in the header) lets you narrow the visible list by date range, status, priority, category, tags, recurrence, and meaningful flag. Filters are applied per tab.

Saved views

Once you have a useful filter combo, save it as a named view. The view chips appear at the top of the panel. Tap to apply, long-press for actions (rename, update with current selection, delete).

Categories and tags

Both classify items, but they behave differently:

• Category: single-select (one per item). Drives the row's left-edge bar colour by default.
• Tags: multi-select (up to three per item). Don't drive colour, just appear as chips.

Manage both from the kebab menu in the header (Categories, Tags). Each gets its own list with rename, recolour, delete.

Quick capture

The floating purple button is for fast adds without leaving your current view. Tap it, type, submit. Works for to-dos by default; flip the type chip to add an event or note instead.

Natural language

The title input parses common phrases inline:

• tomorrow, monday, next week → sets the date
• at 14:00, at 2pm → sets the scheduled time
• high priority, urgent → priority chip
• @category-name → category chip
• #tag-name → tag chip
• every monday, daily → recurrence

The action-row chips below the input update live as you type, so you can see what's been parsed. Tap any chip to override.

If you literally want a # or @ in the title (rather than a tag/category match), prefix with a backslash: \#hash.

Themes

18 themes live under Settings → Appearance → Theme: nine light Pastel Drift themes (Lavender, Sage, Mint, Rose, Orchid, etc.) and nine dark Iron Drift themes (Charcoal, Pine, Walnut, Teal, Burgundy, Plum, etc.).

Each is a complete palette: accent, background gradient, text tiers, surface colours. Switching is instant and doesn't reload anything. The status bar matches the theme automatically.

If you have system-level dark mode on, the app uses your last-picked dark theme. If on light, the last-picked light theme. The choice persists per device.

Extras

Optional features grouped under Settings → Extras.

Rage shake

Stuck? Shake the phone three times within a second. A bottom-up popup slides in with one of today's undone to-dos and a motivational line. Auto-dismisses in 3 seconds, or tap to skip. Picks today's most urgent (pinned, then highest priority, then earliest order).

Weather

A short weather flourish on the first cold-open of each calendar day. Animated background per category (clear / partly cloudy / cloudy / fog / rain / snow / thunder), temperature, and high/low. Uses your device's coarse location to fetch from Open-Meteo. Once-per-day only — restart the app the next morning to see it again.

Both Extras default to ON; toggle off in Settings to disable.

Pomodoro

A focus timer floats in the bottom-right when enabled (Settings → Pomodoro). Default 25-minute work block, 5-minute short break, 15-minute long break every 4 sessions. Configurable.

The timer pill stays visible while running, so you can switch tabs without losing it. A soft chime plays at each phase transition.

Stats and achievements

Two lenses on your activity, both opt-in.

Stats

Always-on view of completion counts, totals, distinct active days, and other lifetime numbers. Open from the kebab menu → Stats.

Achievements

Two layers: Rhythm (six tiers based on consecutive active days) and Badges (twelve milestones for specific accomplishments). Both off by default; enable in Settings → Achievements.

Unlocking a badge fires a confetti animation. Hitting a new rhythm tier surfaces in the Week tab digest.

Data & backup

Everything you create lives in your phone's local storage. Three controls in Settings → Data:

• Export — produces a JSON file with all your to-dos, events, habits, notes, prefs, and saved views. Use it as a backup or to migrate.
• Import — restores from a JSON export. Replaces everything currently in the app, so back up first if you're not sure.
• Factory reset — wipes all data and prefs. Confirmable. Useful for clean-slate testing or if you're handing the device to someone else.

Settings tour

Settings groups its sections by purpose:

• Appearance: theme, font size, bold text, high contrast, reduce motion, bar colour source.
• General: date format, time format, first day of week, startup tab, mirror swipes.
• Event / Task / Recurrents / Habits / Nook: per-domain defaults.
• Notifications: enable, quiet hours, vibration, morning briefing, briefing time.
• Pomodoro: work/break durations, sessions before long break, auto-start, chime.
• Extras: rage shake, weather.
• Achievements / Stats: opt-in toggles for badges and rhythm tiers.
• Data: export, import, factory reset.
• About: version, replay onboarding, privacy link.