Skip to content
isenePublic

About

Fe2O3 on the phone: Android mobile suite (Rust core + Kotlin/Compose shells). tasks, hyperlist, relay, astro, watchit, amardice, xrpn.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

nomad — Fe₂O₃ on the phone

Kotlin Rust Platform License Stay Amazing

The mobile half of the Fe₂O₃ suite. Each app carries one Fe₂O₃ workflow off the laptop and onto an Android phone, sharing a single Rust core and syncing data over Syncthing — no Google account, no cloud middleman.

Landing page: isene.org/nomad

Download: every app as an APK, with three steps to install it, at isene.org/nomad/#get.

One Cargo workspace and one Gradle multi-project in a single monorepo. The interesting code lives in Rust (core/, crate fe2o3-mobile-core), exposed to Kotlin through UniFFI; each app is a thin Compose shell. Anything CPU-bound, data-heavy, or shared between apps belongs in the core, so the phone and the desktop tools compute identically.

The apps are released for inspiration: clone the repo, fire up Claude Code, and prompt the changes that fit your phone.

The apps

App Role Pairs with
gluon Mail, calendar and tasks in one app, as on the laptop: a Home tab with the unread mail, the coming week and the tasks; Gmail search; three home-screen widgets gluon, kastrup, tock, scribe
hyperlist General HyperList editor — full syntax highlighting, fold, drag-reorder across depth, auto-renumber scribe
relay Notification gateway: relays WhatsApp / Messenger / Instagram / SMS / Discord (and photos) to kastrup and fires replies — replaces the laptop's Marionette bridge kastrup
astro Amateur-astronomy companion: ephemeris, met.no weather + observing conditions, in-the-sky events, APOD, starchart, the Moon lit for the day with a named map, and a telescope/eyepiece gear catalog astro, moon
watchit TMDB movie / series browser — top-rated & popular lists, wish/dump lists, posters, full detail, search-to-add watchit
amardice Amar RPG O6 dice roller: D6, skill, combat (crit/fumble tables), and fear rolls amar
rpnx Pocket HP-41 RPN scientific calculator — full stack/registers/modes, multi-shift keypad, and a FOCAL program runner rpnx
vox Voice quick-capture: records on launch, Whisper-transcribes, files the text to your todo.hl Inbox or a notes file — say a time ("remind me tomorrow at 12 08 to …") and it files a stamped, alarmed item laptop VTT
scribe Notes with tags and pictures, as plain Markdown files in a folder you share with your laptop: a list or cards, search, #tags, photos from the camera or gallery, and an import from Google Keep scribe
ref Offline searchable reference reader — glossaries, books, and writings as JSON collections (bundled + synced) —
gazette Reader for your personal daily news digest — browse the last 7 daily issues (and the typeset PDF) synced into ~/.news, open source links gazette
books The library on your phone: read the books you grabbed and had written on the laptop, grouped by shelf, with inline figures and spoken tracks (only finished books appear) library
onepage Minimal home-screen launcher: one screen, widgets placed freely, your apps in a panel on a swipe up (switched off while a bank app runs), folders three to six icons wide, zero idle cost —
gaze Web browser around Android's WebView: tabs sent to and from the laptop, the laptop's encrypted passwords and bookmarks, ad blocking, dark pages, and Claude to ask about the page gaze
fresh Every installed app, newest first: tap opens one, long-press for app info or uninstall —
pointer File manager: tag items, walk to another folder, copy or move them there; a trash, undo for every step, tabs, archives that open as folders, search inside files, marked folders that other apps can save into, and no network permission pointer
prism Colour picker: a foreground and a background, R/G/B and H/S/V sliders, hex, sample text and the WCAG contrast of the pair, copy in four formats prism
science Six subjects as tabs: the periodic table, 3,386 isotopes, the Standard Model, 461 stars on the HR diagram, 6,309 exoplanets, and 37 steps from the quantum foam to the universe elements, isotopes, particles, stars, exoplanets, universe
fleet A buzz when a Claude Code session on the laptop finishes: work given an ETA, or every finished turn fleet
vault Passwords from the laptop's encrypted file: type to find one, a tap copies its password for 30 seconds, tags as tabs, change or add entries; no network permission vault

Each ships as its own signed APK with its own launcher icon. The newest build of each is one tap away on the landing page; tools/publish <app> puts it there.

Architecture

nomad/
├── core/                       fe2o3-mobile-core (Rust, UniFFI)
│   ├── src/hyperlist*.rs        HyperList model, parser, highlighter
│   ├── src/astro/               ephemeris (orbit), weather, events, gear, images
│   ├── src/watchit/             TMDB models, parsers, filter/sort
│   ├── src/amardice.rs          O6 engine + crit/fumble/fear tables
│   ├── src/mail.rs              mail records + read state (fe2o3-mail)
│   ├── src/pointer.rs           file manager: list, search, copy, move, trash, undo, archives
│   └── src/xrpn/                RPN stack engine, formatter, FOCAL interpreter
├── apps/<name>/                 Kotlin/Compose shells (one Gradle module each)
├── tools/logo                   launcher icon from an app's logo.svg
├── Cargo.toml                   workspace root
├── settings.gradle.kts          Gradle multi-project root
└── gradle/libs.versions.toml    shared Android/Kotlin version catalog
  • Rust core + UniFFI for all logic. Never hand-rolled JNI.
  • Compose for screens, Glance for widgets, WorkManager for background work (respecting Doze and App Standby).
  • No business logic in Kotlin that could live in the core.

Design hierarchy, build quirks, and per-app notes live in CLAUDE.md.

Build

# Rust core — host tests (no emulator needed)
PATH="/usr/bin:$PATH" cargo test -p fe2o3-mobile-core

# An app's signed release APK
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
export ANDROID_NDK_HOME="$HOME/.android-sdk/ndk/27.2.12479018"
./gradlew :apps:<name>:assembleRelease

cargo-ndk cross-compiles the core to all four Android ABIs; uniffi-bindgen generates the Kotlin bindings at build time. The APK lands in apps/<name>/build/outputs/apk/release/.

Sync to phone

Build the signed APK, drop it (and any shared data files) into a Syncthing-shared folder, and sideload on the phone. Per-app data — ~/.tasks/todo.hl, ~/.astro/gear.json, the relay gateway dir, .xrpn programs — rides the same Syncthing channel, so the phone and the desktop Fe₂O₃ tools share one source of truth.

License

Unlicense — public domain. Borrow or steal whatever you want.

— Geir Isene

About

Fe2O3 on the phone: Android mobile suite (Rust core + Kotlin/Compose shells). tasks, hyperlist, relay, astro, watchit, amardice, xrpn.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages