Documentation

MiMo (Mind & Motion) is a quiet, airy place for your thoughts and your action — everything lives around a single central bubble.

Open the app and sign in with your username and password, or create an account. If your instance has Authentik configured, you can continue with Authentik instead.

Everything revolves around the bubble in the middle (it shows your name). • Mind (left) — your thoughts, called waves. • Motion (right) — your action, organised into spaces (each holding steps). • Profile (top) — your info and preferences. • Archive (bottom) — your completed/archived things.

• Scroll (or two-finger swipe) up/down to glide between Profile ⇄ Bubble ⇄ Archive. • The small icons on the bubble's edges do the same. • Drag the bubble left/right to jump into a full-screen Motion or Mind view. Click the bubble to return to the centre.

Waves are your thoughts — a word or a sentence. • Click the left edge of the bubble (or + New wave) to create one. Pick a title, an optional description, and a type. • Each wave is a bullet list, checklist, or range (a 1–5 slider with per-day history). • Click a wave to expand it; use the pencil icon to edit. • The priority dropdown sits in the top-right of an expanded wave. • Archive / Delete are in the bottom-left.

Spaces are your action — kanban-style columns. Each space holds steps. • Click the right edge of the bubble (or + Add Space) to add a space. • Up to 6 spaces. • Add, drag, and tick steps; change a step's type between step and list. • A list step has a > button to open a big panel and add subtasks. • Set priorities and tags on steps.

A toggle in Profile → Spaces workflow (on by default) uses a fixed three-space flow: Wishes, Catalysts, Non-negotiables. Uncheck it to build your own custom spaces — both are kept safe.

Declare your own priorities in Profile → Priorities: give each a name and a colour. They appear as coloured chips on waves and steps.

Create up to 5 tags in Profile → Tags. Tag a step with the tag icon in its row, then use the tag icon at the top of a space to filter that space's steps by tag.

Reach it from the bubble's top edge. Set your name, age, pronouns, wishes, language, and font; manage priorities, tags, daily insight, ambient sound, account, suggestions, and donations.

Reach it from the bubble's bottom edge. Archived waves and completed steps float here. Filter by All / Waves / Steps / Insights and sort newest or oldest. In Insights, a calendar button lets you browse past daily insights by day.

Once a day, your bubble glows and shows 'insight' — click it to answer a short question in one or two words. Answers collect in Archive → Insights, grouped by date.

From Profile → Donations you can support MiMo. Every euro after the first €150 goes 70% to that month's charity and 30% to the MiMo team; the charity rotates monthly.

Open the friends button to see your friends. Add a friend by entering their friend code. Peek their bubble (mutual friends only, read-only). Hide your bubble from them or delete them from the menu.

• Sound begins automatically (your browser may wait for a first click); mute it from the speaker button. • Scrolling inside a list scrolls that list. • Everything is saved as you go.

• Windows desktop: on Windows, install Node.js and Rust (MSVC toolchain). Then: cd desktop && npm install && npm run build:desktop Upload desktop/src-tauri/target/release/bundle/nsis/MiMo_0.1.0_x64-setup.exe to a Forgejo release tagged v0.1.0. • Linux desktop (Debian/Ubuntu): sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf. • Linux desktop (Fedora): sudo dnf install webkit2gtk4.1-devel libappindicator-gtk3-devel librsvg2-devel patchelf openssl-devel gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good. Then: cd desktop && npm install && npm run build:desktop (or build:fedora on Fedora) Upload the AppImage + mimo-icon.png. • Server: cp .env.example .env, set JWT_SECRET + APP_URL, then docker compose up -d --build. • Admin: ./admin-manager.sh make-admin <user> --hash <salt:hash> (or ADMIN_USERNAME/PASSWORD in .env). • Restore a DB: copy .data/bubble.db and .data/.jwt-secret into the mimo-data volume. • Landing page: edit config.js to production URLs, then docker compose up -d --build.