What is TapTidy? Both #

TapTidy is a task manager built for people who want to stay organized without fighting their tools. It runs on the web and on Android, with full offline support on both platforms. Your tasks sync automatically when you reconnect — no manual save, no data loss.

At its core, TapTidy is designed around a few principles:

• Offline-first. Everything works without a connection. Edits queue locally and sync when you're back online.
• Natural language. Type "call dentist tomorrow at 2pm #health" and TapTidy creates the task, sets the date, and tags it — on both platforms.
• Privacy by default. Optional end-to-end encryption means your data is unreadable on the server. You hold the keys.
• No lock-in. CalDAV sync, JSON/CSV export, and an open API mean your data is always yours.

TapTidy includes tasks, projects, routines, a Pomodoro timer, focus mode, email capture, home-screen widgets, smart notifications, and more. This documentation covers every feature across both platforms.

Quick Start (Web) Web #

Get up and running in under a minute.

Quick Start (Android) Android #

Install TapTidy from the Play Store and sign in with your account.

Your First Task Both #

Tasks are the building blocks of TapTidy. Here's a quick walkthrough.

Creating a task

On the web, press C or click the capture bar. On Android, tap the (+) button. Type naturally:

Editing a task

Click or tap a task to open its detail view. Change title, due date, priority, project, tags, subtasks, or notes.

Completing a task

Click the checkbox (web) or swipe right (Android). The task moves to your completed list.

Tasks Both #

A task is anything you need to do. Every task has a title and can optionally have:

Recurrence

Set tasks to repeat on a schedule using RRULE patterns:

When you complete a recurring task, the next occurrence is generated automatically.

Projects Both #

Projects group related tasks together. Every task belongs to a project (or to the default Inbox if you don't assign one).

Creating a project

Open the project list and create a new project. Give it a name, choose a color, and optionally pick an emoji icon. Colors help you distinguish projects at a glance in board view and calendar view.

Organizing tasks

Assign a task to a project when creating it (use the project field in the task editor, or name the project in natural language capture). You can also drag tasks between project columns in board view.

Project views

Click a project in the sidebar to filter your view to just that project's tasks. This works in list, board, calendar, and timeline views.

Sharing projects

Share a project with other TapTidy users. Assign roles: viewer (read-only), editor (can modify tasks), or admin (can manage sharing). Shared projects sync in real time — you'll see collaborators' presence indicators when they're active.

Views Both #

Four ways to look at your tasks. Switch using the view picker in the toolbar.

Board view

Kanban columns grouped by project, priority, or status. Drag tasks between columns on the web.

Calendar view

A month grid showing tasks on their due dates. Tap a day to see its tasks.

List view

A flat, sortable list. Sort by due date, priority, project, or creation date. The default view for daily planning.

Timeline view

An hourly view for time-blocking. Tasks with specific times are positioned along the timeline. Supports hourly, 2-hour, and 4-hour zoom levels with a 6-day range.

Custom views

On the web, save a filter+grouping combination as a custom view. Example: "This week, high priority" — priority 1–2 tasks due in 7 days, grouped by project.

Focus Mode Both #

A distraction-free environment for working on one task at a time.

Starting a session

Press F on the web, or tap the focus icon on any task card on Android. Select a task and start.

During a session

Everything strips away except your task and a timer. Drift too long without activity? TapTidy nudges you back. On web, Focus Mode uses the Fullscreen API. On Android, system UI is minimized.

Session insights

When you end a session, see a summary: duration, focus score, and current streak.

Natural Language Capture Both #

Type tasks the way you think. TapTidy's NLP engine — built in Rust, running natively on both platforms — extracts structure from plain text.

See it in action

Syntax reference

How it works

Both platforms use the exact same parsing logic. The parser is timezone-aware — relative dates are resolved using your device's local time.

Routines & Habits Both #

Routines are recurring activities you want to build into habits. Unlike recurring tasks, routines track a persistent template with daily or weekly occurrences.

Schedule types

Tracking progress

The routine detail shows a heatmap, your streak, and a frequency progress bar.

Difficulty modes

Each routine can be Easy, Balanced, or Hard — affecting reminder intensity and streak strictness.

Timer & Pomodoro Both #

A built-in Pomodoro timer for focused intervals.

How it works

Sessions cycle through focus (25 min), short break (5 min), and long break (15 min after 4 sessions). All durations are configurable. The timer auto-advances between phases.

Task association

Link a session to a task. Time spent shows in the task detail and Stats screen.

Platform differences

• Web: The timer appears as a persistent overlay in the top-right corner. It stays visible as you navigate between views.
• Android: The timer runs as a foreground service with a persistent notification. It continues even when the app is in the background. Sound and vibration play on phase completion.

Email Capture Web #

Forward emails to TapTidy to turn them into tasks.

Setup

In Settings → Email, claim your unique capture email address. Once verified, any email forwarded to that address is processed and appears in your Inbox.

How it works

TapTidy's inbound email pipeline receives the message, classifies it as actionable or reference material, and creates a capture item. You review captures in the Inbox screen, where you can convert them to tasks, assign projects and tags, or dismiss them.

Smart classification

An ML-based classifier scores each email for actionability. High-confidence items get suggested tags and projects. You can adjust the sensitivity in Settings.

Widgets Android #

Home-screen widgets for quick task access without opening the app.

Task List widget

Stats widget

A smaller widget showing your completion percentage or time tracked for the day.

Theming

Widgets follow your app theme (light/dark) and adapt to dynamic colors on Android 12+.

Notifications & Escalations Android #

TapTidy's notification system goes beyond simple reminders. It uses a multi-stage escalation model to help you stay on top of tasks without being overwhelmed.

Notification channels

TapTidy creates separate Android notification channels so you can control each type independently:

Three-stage escalation

When a task becomes overdue, TapTidy escalates through three stages:

Escalation timing is configurable in Settings → Notifications.

Quiet hours

Suppress all non-urgent notifications between a start and end time (e.g., 10 PM to 7 AM). Configure in Settings → Notifications → Quiet Hours.

Priority routing

Tasks at priority 1 or 2 are routed to the Urgent Reminders channel, which can have a different sound and vibration pattern than standard reminders. The threshold is configurable.

Snoozing

Swipe a notification to snooze it. The default snooze delay is 10 minutes (configurable). You can also set a custom snooze time using phrases like "in 1 hour" or "tomorrow 2pm".

Stale task resurfacing

If you snooze a task multiple times without acting on it, TapTidy will resurface it with a stronger notification after a configurable delay.

Cross-device deduplication

If you use TapTidy on multiple devices, notifications are deduplicated within a 90-second window to avoid double alerts.

Quick Capture Android #

Multiple ways to capture tasks without opening the full app.

Notification quick-add options

• Keep pinned after use (repost after a configurable cooldown)
• Smart default project (Inbox or last-used project)
• Custom vibration and sound settings

Share intent

Share text, URLs, or images from any app into TapTidy. The share receiver extracts the content and opens a pre-filled task creation dialog. Great for saving articles, turning messages into tasks, or capturing ideas from other apps.

Widget inline add

Tap the add button on the Task List widget to create a task without leaving your home screen.

Voice capture

Use the microphone icon in the Inbox screen for voice-to-text task creation.

Keyboard Shortcuts Web #

Power through your task list with keyboard shortcuts. Press ? in the app to see all shortcuts.

Global shortcuts

Navigation

Task navigation (Vim-style)

Selection

Filters & Custom Views Both #

Narrow down your task list to see exactly what matters right now.

Quick filters

Use the filter chips in the toolbar to quickly filter by tag, project, priority, or status. Filters combine — selecting "work" tag and priority 1 shows only urgent work tasks.

Saved filters

Save a filter combination for reuse. Saved filters appear in the sidebar for one-click access. Useful for recurring views like "This week's meetings" or "High priority errands".

Custom views (Web)

On the web, go further by saving a filter + grouping + sort order as a custom view. Custom views appear in your sidebar alongside the default views.

Advanced filter builder (Android)

The Filter Builder screen on Android lets you construct complex filters with multiple conditions, AND/OR logic, and date ranges.

Collaboration & Sharing Both #

Work on tasks and projects with others in real time.

Roles

Real-time presence

When multiple people have a shared task open, TapTidy shows presence avatars so you know who else is viewing or editing.

Conflict resolution

If two people edit the same task while offline, TapTidy detects the conflict on sync. A merge view lets you compare changes and choose what to keep.

Import & Export Web #

Bring your tasks into TapTidy from other apps, or take them out whenever you want.

Import

The Import Wizard supports:

• Todoist — Connect your Todoist account and import projects, tasks, and labels.
• Asana — Import projects and tasks from Asana workspaces.
• CSV/JSON — Import tasks from a structured file. Map columns to TapTidy fields during import.

Export

Export your data in three formats:

• CSV — Spreadsheet-compatible, great for analysis.
• iCal — Calendar-compatible, import into Google Calendar or Apple Calendar.
• JSON — Full data export including metadata, subtasks, and tags.

Exports are available from Settings → Sync & Data → Export.

Zapier Integration Android #

Connect TapTidy to thousands of other apps via Zapier webhooks.

Available triggers

• Task created — Fires when a new task is created.
• Task completed — Fires when a task is marked done.
• Routine completed — Fires when a routine occurrence is completed.

How it works

Events are queued locally and dispatched via a background WorkManager job. If you're offline, events queue until connectivity returns. Configure your Zapier webhook URL in the app's integration settings.

Android Auto Android #

Access your tasks while driving, hands-free.

What you can do

• View tasks — Browse tabs for Today, Overdue, and All tasks on your car's head unit.
• Voice quick-add — Say a task and TapTidy creates it using the NLP engine.
• Mark complete — Complete a task with a single tap.
• Snooze — Snooze a task for 30 minutes.

The Android Auto interface is read-only for safety — you can view and complete tasks but not edit them in detail.

End-to-End Encryption Both #

Optional E2EE so your task data is unreadable on the server.

Device key management

Each device registers a key. View and revoke keys in Settings → Advanced → Encryption.

Key rotation

Rotate keys periodically. New data encrypts with the new key; old data re-encrypts in the background.

Pro Privacy tier

E2EE is available on any Pro plan. Pro Privacy just starts with it enabled by default.

Offline-First Architecture Both #

TapTidy works fully offline on both platforms.

Local storage

Conflict resolution

If the same task was edited on multiple devices while offline, TapTidy detects the version mismatch. A conflict resolution screen lets you compare changes side-by-side and choose how to merge.

Status indicators

Both platforms show connection status. On Android, an enhanced offline banner shows pending mutation queue size.

CalDAV Sync Both #

Sync your TapTidy tasks with any CalDAV-compatible calendar client — Thunderbird, GNOME Calendar, NextCloud, Apple Reminders, and more.

How it works

TapTidy includes a built-in CalDAV server that exposes your tasks as VTODO items. CalDAV clients connect to your TapTidy server and sync tasks bidirectionally.

Setting up a client

In your CalDAV client, add a new calendar account with:

Server: https://your-taptidy-instance/caldav
Username: your email
Password: your app password (generate one in Settings)

Per-list routing

TapTidy can route individual projects to different sync backends. For example, sync your "Work" project via CalDAV to Google Calendar while keeping "Personal" on TapTidy's native sync. Configure this in the project's sync settings.

Data Backup Both #

Your data is always yours. TapTidy provides multiple ways to back up and export.

Cloud backup (Android)

The Android app supports cloud backup and restore. Navigate to Settings → Sync & Data → Backups to create a backup or restore from a previous one.

Export (Web)

Export all your data as JSON, CSV, or iCal from Settings → Sync & Data → Export. JSON exports include full metadata — projects, tags, subtasks, notes, and completion history.

Self-hosting (coming soon)

TapTidy will be available to self-host in the future. The server is a Node.js application backed by PostgreSQL and Redis. When available, you'll be able to deploy it on your own infrastructure and own your data completely.

Web Settings Web #

Access settings from the gear icon in the app header or from the user menu.

General

• Theme — Light, Dark, or Auto (follows system preference).
• Default view — Which view loads when you open the app (List, Board, Calendar, or Timeline).

Notifications

• Browser notifications — Enable push notifications for task reminders in the browser.

Capture & Focus

• Inbox assist — Smart filtering and organization suggestions for captured items.

Sync & Data

• Email settings — Configure your email capture address and SMTP provider.
• Todoist sync — Connect or disconnect your Todoist account.
• Export — Download your data as JSON, CSV, or iCal.

Advanced

• App passwords — Generate passwords for CalDAV clients and API integrations.
• Encryption — Enable or manage E2EE device keys.
• Account — Change password, verify email, or delete your account.

Android Settings Android #

TapTidy's Android settings are organized into five categories. Access them from the navigation drawer → Settings.

General

Notifications

Capture & Focus

Sync & Data

Advanced

Plans & Pricing Both #

FAQ Both #

Is there an iOS app?

Not yet. TapTidy currently supports the web and Android. You can use the web app on iOS Safari in the meantime — it works well on mobile browsers.

Can I self-host TapTidy?

Not yet, but it's coming soon. TapTidy's server is a Node.js application backed by PostgreSQL and Redis. When self-hosting is available, all features will be included with no subscription limits.

How do I import from Todoist?

On the web, go to Settings → Sync & Data and connect your Todoist account. The import wizard walks you through selecting which projects and tasks to bring over.

What happens if I go offline?

Everything keeps working. Tasks, routines, and completions are saved locally and queued for sync. When you reconnect, TapTidy syncs automatically. If conflicts arise (edits on multiple devices), you'll see a merge screen.

Can I use TapTidy with Google Calendar?

Yes, via CalDAV sync. TapTidy exposes your tasks as VTODO items that any CalDAV client can subscribe to. You can also route individual projects to a Google Calendar CalDAV backend.

Is my data encrypted?

Data is encrypted in transit (TLS) by default. For at-rest encryption, enable E2EE in Settings. With E2EE enabled, your task content is encrypted on-device before being sent to the server. The server stores only ciphertext.

How do I cancel my subscription?

Go to Settings → Account → Billing. You can downgrade to Free at any time. Your data is preserved, but features beyond Free-tier limits become read-only until you're within the limits.

Can I use the API directly?

Yes. TapTidy has a REST API documented via OpenAPI. Generate an app password in Settings → Advanced → App Passwords and use it for authentication. The API supports session cookies, bearer tokens, and basic auth.

How does the on-device AI work?

On Android, TapTidy can run a small language model locally via llama.cpp for subtask suggestions, note summarization, and priority classification. The model is downloaded optionally and runs entirely on-device — no data is sent to any AI service. If the model isn't available, the app falls back gracefully.

What NLP syntax is supported?

See the Natural Language Capture section for a complete syntax reference, including dates, times, tags, priorities, projects, and recurrence patterns.