Frequently Asked Questions

Common questions about using the Todo App for personal task management.

General

What is the Todo App?

The Todo App is a lightweight personal task management application within FlowState. It provides simple, focused todo tracking with priority levels, due dates, and completion status. Unlike the full Projects App, it's designed for quick personal task capture without project or milestone overhead.

Who is the Todo App for?

The Todo App is designed for:

How is this different from the Projects App?

The Todo App is intentionally simple for personal productivity.

Using the App

How do I create a todo?

1. Click "New Todo" in the sidebar or header
2. Enter a title (required)
3. Optionally set priority, description, and due date
4. Click Save

See Creating a Todo for detailed steps.

What priority levels are available?

The Todo App supports three priority levels:

Can I set a due date?

Yes, due dates are optional. When creating or editing a todo:

1. Find the Due Date field
2. Click to open the date picker
3. Select your desired date
4. The todo will display the due date in the list

How do I complete a todo?

1. Navigate to your todo list
2. Click on the todo you want to complete
3. On the detail page, toggle the completion status
4. The todo will be marked as complete

Can I edit a todo after creating it?

Yes, click on any todo in your list to view its detail page, where you can:

• Edit the title
• Update the description
• Change the priority
• Modify the due date
• Toggle completion status

How do I delete a todo?

On the todo detail page, look for the delete action. Deleting a todo is permanent and cannot be undone.

Data & Privacy

Where is my data stored?

Your todos are stored in multiple locations:

The local-first approach means your todos are available even when offline.

Can others see my todos?

No. The Todo App is for personal use only:

• Each user has their own isolated todo list
• Authentication ensures only you can access your todos
• There are no sharing or collaboration features

Does the app work offline?

Yes, the Todo App uses RxDB with local-first architecture:

• Todos are stored locally in your browser
• You can view and manage todos without internet
• Changes sync when you're back online

How do I export my todos?

Currently, the Todo App does not have a built-in export feature. To export your data:

1. Open DevTools > Application > IndexedDB
2. Navigate to the todos collection
3. Copy the data manually

A proper export feature may be added in future versions.

Authentication

Why do I need to sign in?

Authentication provides:

• Privacy - Your todos are only visible to you
• Sync - Access your todos across devices
• Security - Protect your personal task data

What authentication methods are supported?

FlowState supports:

• Email authentication
• Phone number authentication

Choose whichever method is most convenient for you.

My session expired. What do I do?

If your session expires:

1. You'll see an "Authentication Required" message
2. Click "Sign In"
3. Re-authenticate with your email or phone
4. You'll be redirected back to where you were

Your todos remain safe locally even when your session expires.

Can I use the app without signing in?

The Todo App requires authentication to ensure your todos are private and associated with your account. In standalone development mode, mock authentication is available for testing.

Technical

Which browsers are supported?

The Todo App supports modern browsers:

Does it work on mobile?

Yes, the Todo App is responsive and works on mobile browsers. However, for the best experience, consider using the FlowState desktop or native mobile app when available.

What is the app URL?

The base path is /todo within the FlowState application.

How do I report a bug?

To report a bug:

1. Note the exact steps to reproduce the issue
2. Capture any error messages from the browser console
3. Take screenshots if helpful
4. Report through the FlowState support channel

Include:

• Browser and version
• Steps to reproduce
• Expected vs actual behavior
• Console errors

Features

Will filtering be added?

Yes, filtering by completion status (complete/incomplete) is planned for a future release. Currently, all todos are displayed in a single list.

Will sorting be added?

Yes, sorting by priority and due date is planned. Currently, todos appear in creation order.

Can I add tags or labels?

Tags/labels are not currently supported but may be considered for future versions. Use the description field for additional categorization if needed.

Will recurring todos be supported?

Recurring todos are not currently planned. The Todo App is designed to be simple. For recurring tasks, consider the Projects App or a dedicated scheduling tool.

Can I share a todo with someone?

No, the Todo App is designed for personal use only. For collaborative task management, use the Projects App which supports team features.

Troubleshooting Quick Reference

See Troubleshooting for detailed solutions.

Still Have Questions?

If your question isn't answered here:

• Check Getting Started for setup guidance
• Review Features & Capabilities for technical details
• See Troubleshooting for common issues
• Contact FlowState support for additional help