# 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.3.2**, 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. 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 (or the WEEK inbox), tap **"Add a new task…"** at the top of the list, type, and hit **return**. The field keeps its focus after each entry, so you can pour out several tasks in a row — type, return, type, return. New tasks appear right under the field. 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 reveal its actions — **Repeat**, **Edit** and **Delete** — and tap **Edit**. The title becomes editable in place; press return to save. If you clear the text and press return, the edit is discarded — deleting is a separate, deliberate act. ### Delete a task Swipe the row, tap **Delete**, confirm. Deleting removes the task permanently — it does 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 ready to type, straight into the week list. *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 — or let go. That carry-over is the heart of the app: the week resets *cleanly*, and it resets *honestly*. And if you'd rather **decide** than let things flow, that's what the Sunday ritual is for: --- ## Closing the week — the Sunday ritual From **Sunday at 5 in the evening**, the WEEK band shows a quiet invitation: **close the week**. It's the deliberate version of the automatic reset — and entirely optional. - The pass walks your pending tasks **one at a time**, each with three equal-weight exits: **give it a day** in the incoming week · **let it wait** in the week list · **let it go**. - There's a Back while you decide, and you can skip the pass. Finishing — or skipping — settles that week: the app won't ask again. Simply ignoring it leaves Monday's offer open. - **Let it go** archives the task *without* marking it done. It stays in your archive, honestly distinct from the completed ones. - Day choices apply when the new week actually arrives: those tasks land on their chosen day as deliberate placements — not as spillover. - The pass ends in a **sober recap**: one line, and your dots. No streaks, no confetti, no score. From there you can share the week, if you feel like it. - A clean week gets the invitation too — nothing to decide, straight to the recap. - With several contexts, each context closes its own week. Missed Sunday? If tasks carried over, the WEEK band offers to **lay out the week** on Monday instead — the same pass, applied on the spot. --- ## Share your week A story-format (9:16) image of your week: the stacked bands and their dots in your active theme, following light or dark mode, with a one-line recap. - **Dots only, by default.** The card shares the *shape* of your week — never its content. A with-titles mode exists (up to three per day), and choosing it is deliberate **each time**: the app never remembers that choice. - Mid-week the card counts what's *to go*; on closing night it speaks in the closing voice. - Where: the button on the ritual recap, or **Settings → Share your week**. --- ## 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's deliberately unfiltered: even with several contexts, the archive shows one complete history. Two kinds of rows live here: **completed** tasks (accent checkmark, struck through) and tasks you **let go** in the Sunday ritual — archived without being marked done, and shown that way. - **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. --- ## 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 → Repeat**, 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. - To stop a rule, open it (swipe → Repeat, or 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. --- ## Widgets *Free for everyone.* - **Add one**: long-press your Home Screen or Lock Screen → **+** (or Edit → Customize) → search "LuDo Weekly" → 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]] alongside iCloud sync. Task titles on the Lock Screen respect iOS privacy settings and hide when the device is locked. --- ## Themes A small, curated set of five band themes — **Gray** (the default), **Green**, **Teal**, **Navy** and **Violet** — 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) · **Share your week** (the card) · **Archive completed tasks** (the tidy-up button) · **Archive** (the history). - **Contexts** — your contexts (activate, rename, add, delete) and the **theme picker** for the active context. - **Display** — three switches: the **calendar date** under the day name when a day is expanded · 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). - **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 notification settings (there are none to configure — the app never pings you). --- ## 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, the Sunday ritual, the share card, quick capture, the archive, all five themes, all widgets — 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** and **weekly repeating tasks**. 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**, **Repeat**, **Move**, **Move up / Move down** (in-day reordering) and **Delete**. *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 **on your device**, in the app's own database. No account, no sign-in, no third-party servers — the full story is on the [[Privacy|privacy page]]. - The archive is your history; it stays until you delete it. - Deleting the app deletes its database — that's iOS working as designed. Until sync ships, there is no cloud copy. - **Backup export and iCloud sync are on the [[Roadmap|roadmap]]** — sync will travel through Apple's private infrastructure, directly between your devices. --- *This guide describes **LuDo Weekly 1.3.2** (on the App Store since July 17, 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]]**