How steventanyang/lefocus works
Project type and purpose
• This is a cross-platform desktop application built with Tauri.
• Frontend: React + TypeScript, served by Vite.
• Backend: Rust via Tauri, orchestrating audio playback, system “sensing,” activity segmentation, timer logic (“Island”), labels, and persisting data in a local SQLite database.
• macOS-only plugin (Swift + C FFI) to access system-level sensing APIs.
File structure
• Top-level:
• src/… (React Vite app)
• src-tauri/… (Rust backend + tauri.conf.json + macOS plugin under src-tauri/plugins/macos-sensing)
• scripts/… (DB migration helpers)
• package.json, bun.lock (JS/TS dependencies)
• system-design/, docs/ (design documentation)
• src-tauri modules:
• audio/ — generators (rain, binaural, brown_noise)
• db/ — connection, migrations, models, repositories (apps, sessions, segments, labels, context_readings)
• sensing/ — controller, icon_manager, loop_worker, perceptual hashing
• segmentation/ — algorithm, scoring, merge, config
• timer/ — commands, controller, state
• labels/ — CLI commands for label CRUD
• utils/ — logging, common helpers
• macos_bridge.rs — glue to Swift plugin
• Swift plugin (src-tauri/plugins/macos-sensing): exposes MacOSSensingFFI to Rust, manages audio island UI, media monitoring, artwork, interaction, window management.
README
• Describes setup: Rust/Cargo, Swift/Xcode CLI, Bun or npm.
• Scripts for database versioning and migrations.
• Tauri dev commands for building/testing.