Skip to content

Mini-apps and extensions

Small, purpose-built panes that manage their own slice of your lists — a travel checklist or a pipeline, instead of a tag convention you have to remember.

What they are

A mini-app is a panel in the app that owns a specific kind of work. It appears as its own area rather than hiding inside the general task list, which is the difference between "I have a tag for trips" and "I have a trips pane that knows what a trip needs".

They are extensions in the useful sense: they bring their own vocabulary and their own defaults, but they write into the same local database as everything else, so a task created by a mini-app is still a task you can move, tag, and schedule.

Travel checklists

Travel is the one that ships today. available Give it a trip and it produces the checklist that kind of trip needs — the packing list, the pre-departure chores, the things that only matter for that destination — as regular tasks in the right place.

The value is in the template, not the storage: the list of what a trip needs is the part people forget, and the app is where you already look at lists.

Creating one is a short form: a name (leave it blank and the app derives one like "Hiking, Swimming · 5-day"), a trip length, and the activities you plan. The checklist then appears in sections — packing groups plus "before leaving" chores — with clothing scaled to the trip length and extras for longer stays, such as laundry reminders. Finishing every item completes the trip.

Some tasks in a mini-app pane carry a lock: those are managed by the app itself and only their completion can be changed, while the rest remain fully editable. Either way, everything is still an ordinary task in your lists.

Planned

  • Message follow-ups and birthday wishes — Keeping in touch with people, as tasks with a natural cadence. coming soon
  • Job application tracking — A pipeline rather than a list: applied, interviewing, offer, closed. coming soon
  • Outside apps managing part of your lists — Let another program own a section of the tree and keep it in sync. coming soon

How they are modelled

Mini-apps are built on the same primitives the rest of the app uses — managed tags, sections, and tasks — rather than on a private store of their own. That is a deliberate constraint: it means a mini-app can never hold your data hostage, and its tasks show up in every view that already works.

The model is specified in docs/spec/todo2-managed-apps-spec.md; thespec table has its status, andFeature status tracks what is shipped.

Working on one
Mini-apps are the most approachable part of the app to extend: a pane, a template, and the storage layer's managed entities. Start at the contributor guide.

Edit this page on GitHub