# The LuDo Weekly guide The complete manual — everything the app does, gesture by gesture, setting by setting. You don't *need* this to use LuDo Weekly; the app is small enough to learn by tapping around for a minute. But if you like knowing exactly how your tools work, this page is for you. It describes **version 1.5.0**, the one on the App Store today, and it's updated with every release. *Prefer quick answers? The [[Support|support page]] covers the most common questions.* --- ## The screen LuDo Weekly is one screen: **eight stacked bands**. - The top band is the **WEEK inbox** — it shows the week number and holds every task you haven't assigned to a day yet. - Below it, **Monday through Sunday**, one band each. The gradient runs light to dark, top to bottom, so a glance tells you where in the week you are. - **Today opens expanded** when you launch the app. Tap any band's header to expand it; tap it again to collapse. Only one band is expanded at a time — the rest stay visible as a compressed stack, so the week never leaves the screen. - The **⋯ button** on the WEEK band opens **Settings**. - **First install?** Three small starter tasks appear on a fresh, empty install — complete one, drag one, meet the inbox. They're ordinary tasks; keep or delete them freely. - **On iPad**, the same week lays itself out in columns instead of a stack — see [[Guide#On iPad|On iPad]] below. That's the whole map. There are no other screens to learn — just Settings, and the Archive behind it. --- ## Tasks ### Add a task Expand a day and tap the orange **+** in its header. A small composer appears — a field and an arrow, nothing else. Type, send, type, send: each task drops into the day right under it and the field keeps its focus, so you can pour out several in a row without ever leaving the day. The destination is the day you opened from, so there's nothing to choose. The **+** on the WEEK band opens the fuller **capture sheet** instead — the same one the widget's **+** opens, and the same one you get when you edit a task. Same typing rhythm, plus everything a task can carry: - **Destination chips** sit under the title: the task lands in the WEEK inbox, and you can retarget it to any day — selecting **several days at once** creates one copy per day. - A row of chips carries the rest of what a task can hold — **Repeat**, **Reminder** and **Details**. Each one states what it's holding (the hour, the number of blocks) rather than just sitting there. They have their own sections further down. - With several contexts, tapping the context pill in the sheet captures into another context without leaving it. A title can hold up to 500 characters, though the app is happiest with short, honest ones. ### Complete a task **Tap it.** A hand-drawn scribble crosses it out, like on paper — and every task keeps its own scribble shape. Tap again to un-complete it. ### Edit a task **Swipe the task row to the right** to reveal **Edit** (a long swipe opens it directly). Editing opens the capture sheet, prefilled: rename the task, move it to another day, send it to another context, and open any of its chips to add a repeat, an hour or a page of details. The checkmark saves and closes. ### Delete a task **Swipe the row to the left**, tap **Delete**, confirm — and the row turns into a five-second **Undo**. Tap Undo to keep the task; let it pass and the deletion is permanent. Deleted tasks do not go to the archive. ### Move a task to another day **Long-press the task, then drag.** It lifts off as a floating glass capsule, the band under your finger highlights, and you can drop it on any day — or back on the WEEK inbox. The task lands at the bottom of its new day's list. ### Reorder within a day The same long-press drag, **inside the same day**: a small orange line shows where the task will land, and dropping it reorders the list. In the WEEK inbox, carried-over tasks keep their own group at the top. ### Capture without opening the app The **"Add Task" action** works from **Siri, Spotlight, Shortcuts and the Action Button**: give it the text and a destination — **This week** (the inbox, the default) or **Today** — and the task lands in your active context. A capture is never lost: if Today has no room on the free plan, the task is saved to the (unlimited) week list and the confirmation tells you so. The widget's **+** works too — it opens the app straight into the capture sheet. And an **iOS Focus mode** can switch your active context automatically: configure it in iOS Settings → Focus, under your Focus's filters. *Using VoiceOver? Every one of these actions has a touch-free equivalent — see [[Guide#Accessibility|Accessibility]] below.* --- ## The WEEK inbox The top band holds tasks that belong to this week but not to a day yet — "sometime this week" is a perfectly good plan. Drag them onto a day once you know when, or complete them straight from the list. The inbox has **no task limit**, in the free version too. It's also where the honest spillover lands when a new week begins — which brings us to: --- ## The weekly reset LuDo Weekly's week runs **Monday to Sunday** — it's in the name: LU-DO, *lunes a domingo*. When a new week begins, the app resets itself. No button, no setting, nothing to remember: - **Completed tasks are archived.** They leave the screen and join the archive — your history. - **Unfinished tasks move to the top of the new week's inbox**, in their own muted tone, listed before everything else. Nothing is deleted, nothing turns red, nothing quietly disappears. The undone travels with you, in plain sight, ready to be given a new day. - **Repeating tasks are the one exception.** A weekly repeating task you didn't get to is not carried over: it's archived as **let go**, and a fresh copy arrives on its own day in the new week. Something that comes back every Monday shouldn't stack up behind itself. That carry-over is the heart of the app: the week resets *cleanly*, and it resets *honestly*. And if you'd rather arrive at Monday already sorted than let it all flow into the inbox, Sunday has an answer: --- ## Plan next week *Free for everyone.* From **Sunday at midnight** — so, all day Sunday — expanding the Sunday card reveals a quiet invitation at its foot: **plan next week**. Tap it and the week gives way to the next one: the same eight bands, marked clearly enough that you can't mistake it for the week you're in, with a way back at the top. - **Next week's inbox arrives already filled** with everything still pending in this week — exactly what Monday would hand you anyway, only now, while you can still do something about it. - **Drag them onto days**, with the same long-press drag you use in the live week. - **Add tasks** here too, with the **+** — the things you already know are coming. - **Nothing leaves this week.** You're arranging the next one; the live week is untouched while you do it. Going back is free, and the plan stays editable all Sunday. - **Finishing a task cancels its own placement.** Complete it before Monday and the assignment quietly disappears — done is done, and it doesn't arrive next week as a job already over. - **You can see where a task is headed** without going back in: a small orange hint in its current-week row names the day it will land on. - **It's free** — and the free plan's three-tasks-per-weekday limit applies to next week's days exactly as it does to this week's. Monday then opens with those tasks already on their days, as deliberate placements rather than spillover. --- ## Reading the dots Collapsed bands carry a small row of dots — the app calls them **TaskDots**, and they're its glance language: - **Each dot is one task**: orange means completed, gray means pending. Up to five dots fit on a band (three on the narrowest iPhones). - If a day holds more tasks than dots, a **+N chip** counts the rest. The chip's color answers the only question that matters at a glance: **orange = everything on that day is done; gray = something is still pending.** - While one band is expanded, the others dim — but completed dots stay orange, so "how much is done" remains readable. You can turn the dots off in Settings if you prefer bare bands. --- ## The archive **Settings → Archive.** Every task the weekly reset (or you) archived, grouped by week, newest first. It's the app's memory, and it always **opens complete** — every week, every context, nothing hidden. Two kinds of rows live here: **completed** tasks (accent checkmark, struck through) and tasks that were **let go** — archived without being marked done, and shown that way. Let-go rows come from the weekly reset, when a repeating task's copy for the week goes undone. - **Filter what you're looking at**: by week range, by context, and with repeating tasks hidden if they're crowding the view. Filters last for the session only — they're never remembered, so the archive always opens whole next time. - **Export what you're looking at**: the filters set the scope, and the export hands you exactly that view as **Markdown** or **JSON**. - **Swipe a row** to delete it permanently, or use **Delete All** to empty the archive. - There is **no un-archive** — the archive is a record, not a staging area. - Want to tidy up before Monday? **Settings → Archive completed tasks** archives everything currently completed, on the spot. --- ## Contexts *Part of the one-time unlock.* Some weeks are really two or three weeks living in the same head: Personal, Work, a side project. Contexts keep them as **separate planes of the same week** — each with its own tasks, its own color theme, and its own honest spillover. - **Create and manage** them in Settings: up to three contexts besides the default one (which you can rename too). - **Switch by swiping** left or right on the WEEK band — or from Settings. Once you have two or more, a discreet pill on the WEEK band names the one you're in. - **Spillover stays separate per context**: what you didn't finish in Work rolls into next week's *Work* inbox, never tangled with Personal. - Repeating rules belong to a context as well. - **Deleting a context deletes nothing**: its tasks — archived ones included — and its repeating rules are simply reassigned to the default context. The bound is deliberate. Four planes at most: LuDo Weekly is a week planner, not a filing system. --- ## Shared contexts *Part of the one-time unlock — for both of you.* A context you created can be shared with **one other person**. You then see the same tasks in the same week, each from your own iCloud account, on your own devices: you add something, it turns up on their week; they complete it, it's complete on yours. - **There's no owner and no guest.** The two sides are exactly alike, and either of you can end the share. When it ends, **you each keep a complete, working copy** of the context — every task, archived ones included. Nothing is taken away from anyone, ever. - **One person, never more.** Two people planning a shared week is coordination; three would make it a team board, which is a different app. - **The default context can't be shared** — only the contexts you created yourself. - **The name travels, the color doesn't.** You both see the same context name; the theme stays personal, so the week can be Teal on your phone and Sand on theirs. - **Both sides need the unlock**, plus a free slot among their contexts. If the person accepting hasn't unlocked the app, it offers the unlock right there and picks the invitation back up afterwards. - **No notifications.** Nothing buzzes when the other person adds or ticks something off — coordination here happens by glance, like everything else in the app. Sharing a context — and ending the share — lives in the same **Contexts** list in Settings, and it's the same single verb on both sides. --- ## Weekly repeating tasks *Part of the one-time unlock.* For the things that come back every week — Monday stand-up, Friday review, Sunday reset. - **Swipe a task right → Edit** and flip **Repeat weekly**, pick the weekdays, save. Or create a rule from scratch in **Settings → Repeating tasks**. - Every new week, right after the reset, each rule drops a fresh copy of the task on its chosen days. Create a rule mid-week and it also fills in the remaining days of the *current* week. - Instances are ordinary tasks with a small **↻ badge** — rename, complete or delete them freely without touching the rule. Deleting one removes it *for that week only*; it returns with the next. - A copy you don't get to doesn't follow you into the new week: the reset archives it as **let go**, and the next copy arrives on its own day. - To stop a rule, edit any of its tasks and turn **Repeat weekly** off — or open the rule in **Settings → Repeating tasks** and choose **Stop repeating**. Existing copies stay, no new ones appear. - Repetition is **weekly only**, by design: no dates, no intervals, no end conditions. The week is the horizon here too. --- ## Reminders *Part of the one-time unlock.* A task can carry an hour, and your phone will remind you of it on the task's own day. - **Set it while editing a task**: the **Reminder** chip sits next to Repeat and Details, and once there's an hour, the chip shows it. - **A reminder needs a day.** A task sitting in the WEEK inbox has no day, so it can have no instant either — and moving a task back to the inbox clears its hour. - **Hours go in five-minute steps.** The app does 10:05 and 10:10, never 10:07 — on purpose, because an hour you can't aim at is worse than a coarse one. - **They're local.** Your own device schedules the notification. Nothing is pushed from a server, because there is no server. - **A reminder dies with its week**, like everything else here. It doesn't outlive the week it belonged to. - **The Apple Watch can set the hour too**; the phone is what actually rings. - iOS will ask, once, whether LuDo may send notifications. If you say no, the hour is still saved — nothing will ring, that's all. Beyond a reminder you set yourself, the app never notifies you. There is nothing else to turn off. --- ## Task details *Free for everyone.* Behind a task's title there's room for the rest of it: notes, and steps to tick off. - **Open them** from the **Details** chip while editing the task. Write a note, or a list of steps you can check one by one as you go. - **Reorder a block** with a long-press and drag — order is meaning here, so a heading you wrote last can be dragged above the things it introduces. - **Delete a block** the same way you delete a task: swipe it left, tap Delete. - **The glance stays clean.** Details live behind the task, never in the week — the bands keep showing titles and dots, nothing else. - **On the Apple Watch** you can open a task, read its details and tick its steps; the structure itself is edited on the phone or iPad. --- ## On iPad The iPad has its own layout, rebuilt in 1.5.0. - **The week runs in columns** instead of a stack, so far more of it is open at once. - **With several contexts, the contexts themselves can run side by side** — one column per plane of your life — and you can drag a task straight from one to another. - **A spine of day names** runs alongside the columns, and it's a drop target too: drop a task on a day's name and it moves to that day. - **Drag goes everywhere**: between days, between contexts, and back to the inbox. - **Keyboard and pointer are first-class**: with a hardware keyboard there are shortcuts for the things you do most, and with a trackpad or a mouse the rows and headers answer the pointer. - Portrait and landscape both, and everything else in this guide works exactly as it does on the iPhone. --- ## Widgets *Free for everyone.* - **Add one**: long-press your Home Screen or Lock Screen → **+** (or Edit → Customize) → search "LuDo" → pick a size. - **Home Screen**: small and medium — the WEEK stripe over your seven days, with the same at-a-glance dots, in your theme. - **Lock Screen**: a compact today view, a gauge, and an inline line. - **Per-context**: long-press the widget → **Edit Widget** → pick a context, or leave it on **Follow the app**. With several contexts you can pin one widget per plane, side by side — and tapping a widget pinned to another context switches you into it. - **Taps land where you'd expect**: on the medium widget, each day opens that day, the WEEK stripe opens the inbox, and the **+** starts a new task on the spot. The small and Lock Screen widgets open today. - The widget mirrors your **Day of month** and **Show TaskDots** settings. - You can't *complete* a task from the widget yet — interactive widgets are on the [[Roadmap|roadmap]]. Task titles on the Lock Screen respect iOS privacy settings and hide when the device is locked. --- ## Apple Watch *Part of the one-time unlock, since 1.4.1.* The whole app, on the wrist — not a stripped remote control: - The **week view** mirrors the eight bands, dots included; tap a day to open it. - **Capture, complete, edit and delete** from the watch, repeat-weekly included. Swipe the WEEK band to switch context, just like on the phone. - **Reminders and details, since 1.5.0**: set a task's hour from your wrist, and open a task to read its details and tick its steps. - **Complications** for your watch face: today's pending tasks, counts, the week number. - The watch keeps its own copy of your week and syncs through the same private iCloud as your other devices. --- ## Themes A small, curated set of six band themes — **Gray** (the default), **Green**, **Teal**, **Navy**, **Violet** and **Sand**, the warm paper tone added in 1.4.1 — in **Settings**, inside the Contexts section. A theme tints the week's background gradient; the orange accent never changes. Every theme has a light and a dark variant and follows your system appearance automatically (there is no in-app dark mode toggle — iOS decides). With contexts, each context carries its own theme, so the color itself tells you where you are. --- ## Settings, one by one - **Tasks** — **Repeating tasks** (your rules) · **Archive completed tasks** (the tidy-up button) · **Archive** (the history, with its filters and its export). - **Contexts** — your contexts (activate, rename, add, delete, and share one with another person) and the **theme picker** for the active context. - **Display** — three switches: the **calendar date** floating over an expanded day · the **day of the month** next to the weekday name (*MONDAY 5*) · **Show TaskDots**, the dots on collapsed bands (the widget follows this one too). - **Backup** — the **iCloud sync** switch (on by default; turning it off keeps your data on the device) · **Export backup** (everything, or just the active context) · **Import backup** (only ever adds — it never deletes what's already there). - **Unlock** — the one-time unlock, and **Restore purchases**. What you *won't* find: a haptics toggle (the app respects the system-wide iOS setting), a dark-mode toggle (follows the system), or any notification settings — the only notification LuDo ever sends is a reminder you set on a task yourself. --- ## Free and unlocked The free version is the real app, not a demo: - **Free**: the full week — inbox, all seven days, drag, reorder, complete, edit, the honest reset, **planning next week**, **task details**, quick capture, the archive with its filters and export, backup export and import, all six themes, all widgets and iCloud sync — with room for up to **three tasks per weekday**. The WEEK inbox is always unlimited. A day's three slots count every task on it, completed or not; archiving (or the weekly reset) is what frees them. - **The one-time unlock** removes the per-day limit and adds **contexts**, **shared contexts**, **weekly repeating tasks**, **reminders** and the **Apple Watch app**. Pay once, keep it forever — future updates included, on every device signed into your Apple Account (**Settings → Restore purchases**). - **Bought LuDo Weekly back when it was a paid app?** You have full access forever, automatically. Nothing to do. - **Never a subscription.** The limit shows itself honestly: adding a fourth task to a day opens the unlock sheet (what you typed is kept), and a full day simply won't accept a dragged task — it springs back home. --- ## Accessibility - **VoiceOver**: every task row is a single element — double-tap to complete or un-complete, and the rotor carries **Edit**, **Move**, **Move up / Move down** (in-day reordering) and **Delete** (repeat-weekly lives inside Edit). *Move* opens a dialog listing every destination — the touch-free equivalent of dragging. Band headers announce the day and its task counts. - **Dynamic Type**: the reading content — task titles, Settings, the Archive — scales all the way into the larger accessibility text sizes (extended in 1.3.1). The oversized day headers stay fixed on purpose: they're display, not reading. - **Reduce Motion** turns springs and flashes into plain crossfades; **Increase Contrast** strengthens the deliberately soft tones; **Bold Text** is honored throughout. --- ## Languages English, Spanish, French, German, Italian, and Portuguese (both European and Brazilian), following your device automatically. To run the app in a different language than the system: iOS **Settings → Apps → LuDo Weekly → Language**. --- ## Your data - Your tasks live in the app's own database on each device and, with **iCloud sync** on (the default since 1.4.0), travel privately between your own devices through Apple's iCloud — no account to create, no sign-in, no third-party servers. The full story, including exactly what Apple can and cannot see — and what changes in a context you've shared — is on the [[Privacy|privacy page]]. - The **sync switch** lives in Settings → Backup. Turning it off keeps everything on the device. - The archive is your history; it stays until you delete it. - Deleting the app deletes its local database — that's iOS working as designed. With sync on, your tasks also live in your iCloud and come back after a reinstall once sync catches up; for an extra safety net before resetting or replacing a device, **export a backup first** (Settings → Backup). - **Backup export and import** ship with the app: a plain file with your tasks, contexts and rules. Importing only ever adds — it never deletes what's already there. --- *This guide describes **LuDo Weekly 1.5.0** (on the App Store since August 27, 2026) and is updated with every release — the [[Changelog|changelog]] lists what each version changed. Found something unclear or plain wrong? Tell me: [**[email protected]**](mailto:[email protected]).* --- **[[Home]]** · **[[Features]]** · **[[Changelog]]** · **[[Roadmap]]** · **[[Support]]** · **[[Privacy]]**