shindakun.net
The attodo.app, uhh... app.
1# Documentation
2
3Welcome to the AT Todo documentation! AT Todo is a decentralized todo application built on the [AT Protocol](https://atproto.com/), allowing you to own and control your task data.
4
5## What is AT Todo?
6
7AT Todo leverages the AT Protocol (the protocol behind Bluesky and other apps) to store your tasks in your own personal data repository. This means:
8
9- **You own your data** - Tasks are stored in your AT Protocol repository
10- **Decentralized** - No central server owns your information
11- **Portable** - Your data can be accessed by any AT Protocol-compatible application
12
13## Features
14
15### Core Task Management
16- ✅ Create and manage tasks with titles and descriptions
17- ✅ Mark tasks as complete/incomplete
18- ✅ Edit and delete tasks
19- ✅ Set due dates with specific times
20- ✅ Organize tasks with tags
21- ✅ Filter tasks by tags and status
22
23### Quick Task Creation
24- ✅ **Command Bar** (Cmd+Shift+P) - Create tasks instantly
25- ✅ **Natural language date parsing** - "tomorrow at 3pm", "in 2 hours"
26- ✅ **Hashtag support** - Automatic tag extraction from #hashtags
27- ✅ **Smart date detection** - Recognizes dates in task titles
28
29### Smart Notifications
30- ✅ **In-app notifications** - Banner showing overdue and upcoming tasks
31- ✅ **Push notifications** - Get alerted even when app is closed
32- ✅ **Smart grouping** - Multiple tasks grouped to avoid spam
33- ✅ **Quiet hours** - Do-not-disturb mode for peaceful nights
34- ✅ **Usage tracking** - Learns when you're most active
35
36### Organization
37- ✅ Create and share task lists
38- ✅ Multiple list membership per task
39- ✅ Popular tags widget
40- ✅ Tag autocomplete
41- ✅ Separate views for incomplete and completed tasks
42
43### User Interface
44- ✅ **Collapsible task input** - Minimize screen clutter
45- ✅ **Synced preferences** - UI settings sync across all devices
46- ✅ Dark mode support via PicoCSS
47- ✅ Responsive design for all screen sizes
48
49### Progressive Web App
50- ✅ Install on any device (desktop or mobile)
51- ✅ Offline access to cached tasks
52- ✅ Native app experience
53- ✅ Fast loading with service worker caching
54
55See the [Features Guide](/docs/features) for detailed information on all features.
56
57## Getting Started
58
59To start using AT Todo:
60
611. **Login with Bluesky (or your own PDS)** - Use your existing Bluesky handle (e.g., `alice.bsky.social`)
622. **Authorize the app** - Grant AT Todo permission to store tasks in your repository
633. **Start creating tasks** - Add your first task and start organizing!
64
65See the [Getting Started guide](/docs/getting-started) for detailed instructions.
66
67## How It Works
68
69AT Todo uses the AT Protocol's repository system to store tasks as records. Each task is stored with the following information:
70
71- **Title** - A brief description of the task
72- **Description** - Optional detailed notes
73- **Tags** - Organize tasks with flexible, user-defined tags
74- **Status** - Whether the task is completed or not
75- **Timestamps** - When the task was created and completed
76
77All tasks are stored in your personal AT Protocol repository under the `app.attodo.task` lexicon. Lists are stored under `app.attodo.list`, and your preferences are stored under `app.attodo.settings`. See the [lexicon definitions](https://github.com/shindakun/attodo.app/tree/main/lexicons) for full schema details.
78
79## Using Tags
80
81Tags help you organize and categorize your tasks. You can:
82
83- **Add tags when creating tasks** - Enter comma-separated tags in the tags field (e.g., "work, urgent, personal")
84- **Edit tags on existing tasks** - Click Edit on any task and modify the tags field
85- **Filter by tag** - Click any tag to see only tasks with that tag
86- **View popular tags** - See your most-used tags in the dashboard
87- **Tag autocomplete** - Get suggestions from your existing tags as you type
88
89Tags are stored in your AT Protocol repository with each task, maintaining full data ownership and portability.
90
91## Pricing
92
93AT Todo offers two tiers to support the community:
94
95### Free ("Forever")
96- **Price**: $0
97- **Includes**:
98 - Unlimited tasks
99 - Unlimited lists
100 - All features included
101 - Your data, your control
102 - No ads, ever
103- **Note**: Free as long as we can keep the server up and want to develop the software. Just log in and get started!
104
105### Supporter ⭐
106- **Price**: $24 per year
107- **Includes**:
108 - Everything in Free
109 - A gold star in the UI
110 - Support development
111 - Help cover server costs
112 - Help keep it free for everyone
113 - Our eternal gratitude
114
115We believe in keeping AT Todo accessible to everyone while giving those who want to support the project a way to do so.
116
117## Privacy & Security
118
119- Tasks are stored in your own AT Protocol repository, these are public as described in the spec
120- AT Todo uses DPoP (Demonstrating Proof-of-Possession) for secure API authentication
121- Your login credentials are never stored on AT Todo servers
122
123## Support
124
125If you encounter any issues or have questions:
126
127- Check the [Getting Started guide](/docs/getting-started) for common questions
128- Report issues on GitHub or Tangled