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. You can also sideload the APK directly — choose the Google variant (includes Firebase push notifications) or the No-Google variant (uses UnifiedPush/ntfy instead).

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 #

Send or forward emails to your personal TapTidy address to turn them into tasks automatically.

Setup

In Settings → Email, claim your unique capture address (e.g. alice@my.taptidy.app). Once verified, any email sent to that address is processed and appears in your Inbox.

How it works

Smart classification & confidence

TapTidy's ML-powered classifier analyzes the subject and body of each email and returns:

• Classification: TASK, INBOX, INFO, or IGNORE
• Confidence score: 0–100%, shown as a badge on each capture card
• Parsed tokens: Automatically extracted due dates, priorities, project names, and tags

Sender trust verification

Every inbound email is checked for sender authenticity using SPF (Sender Policy Framework) and TLS encryption status. A trust badge appears on each email capture:

Email threading

When someone replies to an email that already created a task, TapTidy detects the In-Reply-To and References headers and links the reply to the existing capture as a threaded update — instead of creating a duplicate task. A Thread #N badge shows the position in the conversation.

Attachments

Attachments are preserved and displayed as preview chips on the capture card, showing the filename, file type icon, and size. Supported attachment types include PDFs, images, spreadsheets, and plain text files.

Email Routing Rules Web #

Automatically sort incoming emails into the right project using plus-addressing.

How plus-addressing works

Append a +tag to your handle to route emails to a specific project:

• alice+groceries@my.taptidy.app → Shopping project
• alice+work@my.taptidy.app → Work project
• alice+ideas@my.taptidy.app → Someday / Ideas project

You can also route with hashtags in the subject (#projectname) or bracket tokens ([project:My Project]).

Managing routes

Open Settings → Email → Routing Rules to see and manage your plus-tag mappings.

Spam & Sender Rules Web #

Control which emails create tasks and which get quarantined.

Spam quarantine

TapTidy uses SpamAssassin scoring (via CloudMailin) to detect spam. Emails scoring above your threshold are quarantined instead of becoming tasks. You can adjust the threshold with a slider in Settings → Email → Spam Quarantine.

Sender allowlist & blocklist

In Settings → Email → Sender Rules, manage trusted and blocked senders:

• Allowed senders bypass spam checks entirely — their emails always become tasks.
• Blocked senders are silently dropped — they never reach your inbox.

Rules can match a specific email address (e.g. boss@work.com) or an entire domain (e.g. @trusted.org).

Email Activity Dashboard Web #

Monitor your email pipeline health at a glance.

Metrics overview

The Email Activity dashboard in Settings → Email shows real-time metrics for your account over the last 7, 30, or 90 days:

Event breakdown

Below the metric cards, a bar chart shows the distribution of email events: delivered, opened, clicked, bounced, and complained. Use this to spot deliverability issues early.

Recent issues

Bounces and spam complaints from the selected time range are listed at the bottom so you can investigate specific recipients or sending patterns.

Handle health

If your email handle receives too many bounces (default: 3 in 7 days), it is automatically disabled to protect your sender reputation. The dashboard shows the current handle status and allows you to re-enable it after investigating.

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.

Cleanup Run Web #

Cleanup Run helps you organize scratch notes in one guided pass. It scans inbox items, suggests classification, project placement, tags, due dates, and priorities, then lets you approve changes before applying.

Where to launch it

• Inbox: use the Cleanup Run call-to-action for fast triage.
• Settings → Automation: launch with advanced controls.

Dual review modes

Preview-first apply

Changes are not committed until you press Apply. After apply, TapTidy provides run-level undo so you can roll back quickly if needed.

Clarity Triage Both #

Clarity Triage surfaces tasks that are vague, stale, or under-defined so you can decide what to do with them in one focused pass. Each task is scored on clarity — how well-defined and actionable it is.

Clarity scores

Actions

For each task in the triage view you can:

• Make it real — Opens the task editor so you can add a due date, project, or notes to clarify it.
• Keep — Marks the task as reviewed and removes it from the triage queue.
• Archive — Moves the task to the archive. A 30-second undo window appears so you can reverse the action.
• Delete — Permanently removes the task (with a confirmation step).

Where to find it

Web: Go to Clarity in the main sidebar navigation.

Android: Access via the Clarity Triage option in the main menu.

External Connectors Both #

TapTidy can delegate cleanup-run decisions to trusted external services using scoped run tokens. This keeps automation flexible while preserving user control.

How scoped run tokens work

• Token is bound to one cleanup run.
• Default validity is 1 hour.
• You choose scopes (read, write decisions, apply, undo, metadata updates).
• Tokens are revocable at any time.

Recommended safe-start scopes

Start with read + decision write only. Enable apply/undo once you trust the integration behavior.

Audit trail

TapTidy records token issuance, revocation, external decision updates, apply, and undo events so changes are attributable and reversible.

Zapier Integration Both #

Connect TapTidy to thousands of other apps via Zapier webhooks. Available on both web and Android.

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

Web: Go to Settings → Integrations → Zapier. Generate a webhook secret, add your Zapier webhook URL, and select which events to send. You can view delivery logs and rotate your secret from the same screen.

Android: 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.

Shopping Lists Both #

TapTidy includes first-class shopping list support on both web and Android. Shopping lists are a dedicated project type with a tailored UI for capture, browsing, and in-store use.

Creating a shopping list

Create a new project and set its type to Shopping. It will appear in the Shopping hub (the cart icon in the main navigation) alongside all your other lists.

Adding items

Add items using natural language capture — the NLP engine recognises shopping-style input automatically. Examples:

• milk @dairy — adds "milk" tagged @dairy
• 3x olive oil #pantry — quantity prefix is parsed
• bananas today @produce — tagged with context

Shop Hub (Android)

On Android, the Shop Hub screen lists all your shopping projects in one place. Tap a list to enter shopping mode — a streamlined single-column view designed for in-store use where items can be checked off with a single tap.

Shopping widgets (Android)

Add the Shopping List widget to your home screen for quick access. The widget shows unchecked items from a specific list and lets you check them off without opening the app.

Sync and offline

Shopping lists follow the same offline-first sync as all other tasks. Changes made in the store without signal are queued and synced when you reconnect.

Task Comments Web #

Leave threaded comments on any task to capture context, decisions, or updates alongside the task itself.

Adding a comment

Open a task's detail panel and scroll to the Comments section. Type your comment and submit. Comments are timestamped and attributed to your account.

Real-time delivery

On shared tasks, comments appear instantly for all collaborators via WebSocket push — no refresh needed.

Smart Lists Both #

Smart Lists are dynamic filters that update automatically based on task properties — no manual sorting required.

Built-in Smart Lists

• Today — tasks due today or overdue
• Inbox — uncategorized captures awaiting triage
• High Priority — P1 and P2 tasks across all projects

Custom Smart Lists

On the web, build your own Smart List using the Filter Builder: combine due date ranges, priority levels, tags, and projects into a saved view. Smart Lists update in real time as tasks change.

Stats & Streaks Both #

Track your productivity over time with built-in statistics available on web and Android.

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 can read, add, and edit tasks through the standard CalDAV protocol.

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)

If the client auto-discovers calendars, it will find your tasks calendar automatically. If it asks you to create a new calendar, decline and browse to the discovered one instead.

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.

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 #

Design System Both #

TapTidy keeps web and Android UI aligned using a shared token source, while each platform continues using native rendering and tooling.

Source of truth

• design-system/tokens.json defines colors, priorities, spacing, radii, shadows, and typography.
• Platform outputs are generated and committed. Edit tokens, not generated files.

Generated outputs

• Web: src/ui/src/generated/design-tokens.css, src/ui/src/generated/designTokens.ts
• Android: android/app/src/main/java/com/taptidy/app/designsystem/generated/DesignTokens.kt
• Auto-generated token docs: Design Token Reference

Component galleries

• Web: Storybook stories under src/ui/src/stories
• Android: Compose previews and Showkase browser (debug settings entry)
• Android screenshot workflow: render Compose previews in Android Studio and capture reference images for review docs.

Update flow

1. Edit design-system/tokens.json
2. Run npm run tokens:generate
3. Validate with npm run tokens:check, cd src/ui && npm run build-storybook, and Android compile/tests

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 currently. TapTidy is a hosted service. If self-hosting is something you'd like to see, let us know via the contact page.

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.