Faire is an offline-first OpenSource multiplatform todo app, created with Tauri and Angular. It stores the data using the IndexedDb of your platform's embeded web browser. Besides being offline-first, it offers two ways to syncrhonize your tasks between your devices, one offline, using only your local network, and the other online, using your Google Account (Google OAuth authentication) to store your tasks in a server and synchronize them between your logged in devices.
When using the offline (local network only) synchronization, you can connect two devices on the same network and, after they discover each other, you can send the data from one to another.
Alternativelly you can sign in using Google OAuth. Thus, your tasks' data will be synchronized between signed in devices using Supabase's servers.
Faire is the french infinitive verb equivalent to "to do".
- Tasks (of course)
- Works 100% offline.
- Projects, where you can group tasks by project or themes.
- An inbox area, where you can register all tasks before moving to projects or prioritizing
- Due date and Due time for the tasks
- View of tasks for today
- View of upcoming tasks
- Search tasks
- View all tasks
- Allow undoing when deleting a task or marking it as complete.
- Manual task ordering, for prioritization
- Notifications of tasks reaching their due time (Windows and Linux only)
- Subtasks
- Recurring tasks (daily, weekly, monthly, yearly and week days)
- Synchronization of data between devices connected in the same network
- Fill the due date and due time based on dates typed in the task title (i.e.: "Do this today" sets the due date for today automatically). Both English and Brazilian Portuguese.
- Google OAuth sign in option
- Devices synchronization using Supabase's servers for signed in users
- Update due tasks' date for "today"
- Tags for tasks
- A calendar view of the tasks
- A time tracker to track each task
npm install
npm run tauri build # for windows, linux and macOS
# or run the following for android:
npm run tauri android init
npm run tauri android build
Check Tauri Dependencies to know what to install before building. And check Android Code Signing to know how to set up keys to sign your APK.
mkdir ~/.android/sdk
cd ~/.android/sdk
wget https://dl.google.com/android/repository/commandlinetools-linux-12266719_latest.zip
unzip commandlinetools-linux-12266719_latest.zip
mkdir cmdline-tools/latest
mv cmdline-tools/* cmdline-tools/latest
cd cmdline-tools/latest/
./bin/sdkmanager --licenses
./bin/sdkmanager tools
./bin/sdkmanager platform-tools
./bin/sdkmanager "ndk;27.0.11902837"
# Set environment variables
export ANDROID_HOME=$HOME/.android/sdk
export ANDROID_SDK_ROOT=$HOME/.android/sdk
export NDK_HOME=$HOME/.android/sdk/ndk/27.0.11902837
# Install Rust toolchains
rustup toolchain install stable --target aarch64-linux-android --target armv7-linux-androideabi --target i686-linux-android --target x86_64-linux-android --profile minimal
npm install
npm run tauri dev
# or to test on android emulator or device:
npm run tauri android dev
In order to be able to make OAuth authentication to work on Android Devices, we needed to implement two Tauri plugins in the project:
- shell: Allows us to open an URL outside the app (opens in the user's default browser)
- deep-linking: Allows us to associate the App as the one that will be used to open some kind of URLs.
- single-instance (only desktop): Helps to avoid opening new app instances when the user clicks a deep-link outside of the app.
By using shell plugin, we can ask the Android system to open supabase's authentication URL in a new browser window, allowing the user to reuse their current Google session, instead of having to log in within the App's webview. Our supabase authentication server was configured to redirect the user to an external URL (in this case, https://charlesschaefer.net/faire-todo-app/* prefixed URLs).
Then, when the authentication is finished, Google redirects the user to something like $URL/redirect.html#auth_token=....&refresh_token=..... As Faire is registered as the app that opens this prefixed URLs, the user is automatically redirected to the app, that will receive the URL (including the needed tokens). We can then finish the signin process.
Check the file src/app/services/auth.service.ts (methods signInWithGoogle and handleAuthCallback).
Download the best bundle for your distro from our latest release.
Download the .exe or .msi installers from our latest release.
Download the .dmg file from our latest release.
Faire Todo App at Google Play Store.