BETA / GUIDE

Beta Testing Guide

A short guide for people testing the fair.ninja closed beta. It isn't part of the contract — the Terms of Service control if anything here reads differently.

What's in the beta

The beta covers Tomato only — the focus timer, plan of the day and stats — on the web app (PWA) and on Android. The other apps in this repository (Habit, Board, Todo) are prototypes we use to test the underlying data structure. They aren't part of the beta, and nothing in your invitation asks you to test them.

What to test

• Day-to-day use: starting and finishing focus and break sessions, planning your day, checking your stats, signing in, syncing between your own devices, exporting your data.
• The rough edges: going offline mid-session and coming back online, switching between the web app and Android on the same account, closing the app while a timer is running.
• Anything that feels wrong, confusing, or just not what you expected — that is exactly what a closed beta is for.

How to report feedback

The fastest way: open Diagnostics in the app (Tomato → Account & settings) and press "Send to fair.ninja team." It attaches your recent app diagnostics automatically — device and app information, recent errors, never your task text or e-mail — lets you add a note describing what happened, and sends it in one step. Use it even when nothing visibly broke; a note about confusing behaviour is useful too.

Sending a report is always something you choose to do. Nothing leaves your device on its own.

Prefer e-mail? Write to info@fair.ninja.

Known limitations today

• The Terms of Service and Privacy Policy are a draft (version 13). A lawyer hasn't reviewed them yet, and some sections still hold placeholders. The final version ships before fair.ninja opens to the public beta; your closed-beta testing happens under this draft. Read them: Terms of Service · Privacy Policy.
• Android doesn't sell chips yet. Buying chips works on the web; the Android app can spend chips you've already bought there, but you can't buy them from inside the app during the beta.
• A custom end-of-session sound you upload still plays the default chime on Android, not your sound, in the notification — a known platform limitation we're working on, not a bug you need to report again.

Getting the apps

• Web: open the link in your invitation e-mail and sign in. It's a PWA — add it to your home screen if you want it to feel like an app.
• Android: comes later, through Google Play internal testing, once the web version is frozen. You'll get a separate invitation e-mail with a Google Play link. You'll need Android 8.0 or newer.

Questions

Common questions about accounts, chips, limits and your data are in the FAQ — it isn't part of the contract either; the Terms control if anything differs. Anything else: info@fair.ninja.

Generated from the repository's docs/legal/beta-guide.md. Questions: see section 1.