https://github.com/cachapa/tudo

A simple to-do app
https://github.com/cachapa/tudo

crdt dart flutter sqlite todo

Last synced: about 1 month ago
JSON representation

A simple to-do app

• Host: GitHub
• URL: https://github.com/cachapa/tudo
• Owner: cachapa
• License: apache-2.0
• Created: 2020-11-11T18:42:23.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-08T18:12:42.000Z (8 months ago)
• Last Synced: 2024-12-03T23:50:37.151Z (about 2 months ago)
• Topics: crdt, dart, flutter, sqlite, todo
• Language: JavaScript
• Homepage:
• Size: 2.77 MB
• Stars: 89
• Watchers: 5
• Forks: 11
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


tudo is an experiment on simple, private, synchronized to-do lists.

It uses [sqlite_crdt](https://github.com/cachapa/sqlite_crdt) and is a useful demonstration of the realtime, offline-first capabilities powering [Libra](https://libra-app.eu) and [StoryArk app](https://storyark.eu). 

   

## Try it out

[](https://github.com/cachapa/tudo/releases/latest)

[](https://play.google.com/store/apps/details?id=net.cachapa.tudo)

[](https://apps.apple.com/us/app/tudo-lists/id1550819275)

The server part of this project can be found here: [server](https://github.com/cachapa/tudo_server).

## Features

* **Anonymous**


No mandatory user accounts or tracking of any sort.

* **Shareable**


Lists can be shared between your devices or trusted contacts simply using the list id.

* **Real-time**


Changes to lists propagate immediately to every connected device where the app is open and online.

* **Private**


Each to-do list has a random unique identifier that is effectively impossible to guess.

* **Offline-first**


No loading screens. The app stores all the data it needs locally and works perfectly without a connection.

* **Multiplatform**


Mobile apps for Android and iOS, and more to come.

* **Open-source**


Look at how it's built. Modify it. Host it yourself. Maybe help me improve it?

## How it works

To do lists are stored on the device as [CRDTs](https://github.com/cachapa/sqlite_crdt) which enable conflictless synchronization with an essentially unlimited number of devices. Every device maintains a local copy of the entire database.

A live websocket connection to the server is kept open whenever the app is active and network is available. Local changes are immediately pushed to the network, and remote changes are pulled in real-time. This promotes rapid consistency of the database between all active devices in the network, and allows users to immediately see those changes in the interface.

The clients are built using [Flutter](https://flutter.io), which makes it possible to build applications for all popular platforms from a single shared codebase.

## How to contribute

Please file feature requests and bugs at the [issue tracker](https://github.com/cachapa/tudo/issues).