Lightweight Menu Bar Todos & Notes for macOS
Capture fast. Finish with focus. Local-first · Fast & Minimal · Open Source
English · 简体中文
Floatick is a lightweight, local-first productivity app for macOS, with Omarchy / Hyprland support. On macOS, it lives in the Menu Bar and opens a floating panel when you click its icon. Omarchy uses the tray interaction and window styling described below. The screenshot above shows the macOS interface.
Build the Omarchy edition as an Arch package from source. Follow the Omarchy setup guide to install it and load the bundled Hyprland window rules; the window behavior below assumes those rules are loaded. The supplied rules require Hyprland 0.55+ with Lua configuration.
| Area | Omarchy behavior |
|---|---|
| Open the panel | Right-click the system tray icon → choose “显示 Floatick” (Show Floatick). Unlike macOS, do not rely on a left click to toggle the panel. Launching Floatick again from the application launcher also opens the existing instance. |
| Panel placement | Hyprland rules center the floating panel on the screen where it opens, independently of the tray icon. The panel floats in the current workspace; cross-workspace pinning is disabled because it can cover input-method candidate windows. |
| Window appearance | The outer frame inherits Omarchy’s theme border colors, width, rounding, opacity, and shadow; corners are square by default. Floatick removes its macOS-style rounded shell, custom border, and transparent outer padding. Internal buttons and cards keep their usual styling. |
| Summon shortcut | Configure Super+Ctrl+Shift+F in Hyprland (see the Omarchy guide). Check personal bindings first. Super+Shift+F opens the system file manager; Super+Enter opens the terminal. Floatick uses Ctrl+Enter to save, and does not use Super/Win for app shortcuts. |
| Theme | The system-theme option is labeled Omarchy when its palette is available. It follows Omarchy colors and light/dark mode, updating automatically after theme changes. Explicit Light/Dark keeps Floatick colors. |
| Keyboard shortcuts | Use Ctrl instead of ⌘: Ctrl+N to create, Ctrl+Enter to save, Ctrl+F to search, Ctrl+, for settings, and Ctrl+1/2 to switch between todos and notes. |
| Hide or quit | Esc dismisses an editor or settings drawer first, then hides the panel. Closing the window through the window manager also hides it. To exit, choose “退出 Floatick” (Quit Floatick) in the tray menu or quit from the app’s settings. Automatic collapse on focus loss is configurable in settings. |
| Tray counts and updates | Pending-count labels depend on status-bar support. Update Linux builds by rebuilding and installing the package; the macOS Sparkle updater is not used. |
Floatick defaults to XWayland on Hyprland for desktop panel behavior. Fractional scaling may look less sharp than native Wayland applications. Todos, notes, and tags work the same way, with offline data stored in ~/.floatick.
- Native macOS Menu Bar: Sits quietly in your system status bar with a live pending badge. Click to open directly beneath the tray icon without cluttering your Dock.
- Full-Width Cards & Floating Capsules: Task titles span the full row width without premature truncation. Hovering smoothly reveals frosted action capsules (deadline, edit, copy markdown, delete).
- Separated Browsing & Editing: Check off tasks instantly in the list; open the full TipTap editor drawer on demand via double-click or
⌘N. - TipTap Markdown & Slash Commands: Press
/for interactive checklists, headings, code blocks, and quotes with instant formatting. - Deadlines without Noise: Set due dates directly on task rows. Overdue items stay clearly highlighted without intrusive notification popups.
- Quick Notes & Shared Tags: Capture snippets and thoughts grouped by date. Reusable color tags work across both todos and notes.
- Local-First Privacy: No accounts, no cloud sync, no tracking. All data is saved as plain, readable JSON in
~/.floatick. - Fast, Lightweight & Native: Built with Tauri 2 and Rust with a sub-30MB idle footprint, smooth 120Hz animations, and optional launch at login.
macOS: Download the latest DMG installer from GitHub Releases and drag Floatick to your Applications folder. The installer is a Universal Binary supporting both Apple silicon (M-series) and Intel Macs.
First-Launch Note for macOS: If macOS displays an "unidentified developer" warning, open System Settings → Privacy & Security, scroll down to Security, and click Open Anyway (only required on first launch).
The Sparkle instructions below apply to macOS. On Omarchy, rebuild and install the package as described in the setup guide.
Open Settings → Software Updates (⌘,) to check for a new version, read release notes, or enable daily automatic checks. Sparkle displays download progress and verifies Ed25519 signatures before installing and relaunching, with your confirmation. Automatic checks do not automatically install updates.
Versions 0.4.0 and 0.4.1 do not contain the updater; install v0.4.2 manually once. Updates require an internet connection; your todos and notes remain local. Update preferences are stored in macOS user defaults.
The table below describes macOS. On Omarchy, replace ⌘ with Ctrl and use the tray’s right-click menu to open the panel, as described above.
| Action | Shortcut / Gesture | Description |
|---|---|---|
| Toggle Window | Click Menu Bar Icon | Toggle Floatick panel under the status tray |
| New Item | ⌘N |
Open editor drawer (Todo or Note) |
| Edit Item | Double-click / Hover ✏️ | Open TipTap editor drawer for existing item |
| Save & Close | ⌘ ⏎ (Cmd + Enter) |
Save current item and close drawer |
| Close / Dismiss | Esc |
Closes active drawer first, then collapses panel |
| Search Workspace | ⌘F |
Focus search bar |
| Switch Tabs | Tab / ⌘1, ⌘2 |
Toggle between Todos and Notes views |
| Preferences | ⌘, |
Open Settings drawer (Theme, autostart, pin) |
| Slash Commands | Type / in editor |
Insert task lists, headings, code blocks, quotes |
| Set Deadline | Click ⏰ on hover | Open date & time picker directly on row |
| Copy Markdown | Click ⎘ on hover | Copy title and content as clean Markdown |
| Quit Floatick | Right-click tray / Settings | Quit the application |
Floatick automatically creates human-readable JSON files in your home directory on first launch:
| File Path | Purpose |
|---|---|
~/.floatick/todos.json |
Todos, completion status, deadlines, reminders, and archives |
~/.floatick/notes.json |
Notes content, color tags, pinning, and archives |
~/.floatick/tags.json |
Reusable color tags shared between todos and notes |
~/.floatick/settings.json |
Theme (system/light/dark), language, autostart, and stay-on-top |
Your todos and notes never leave your computer and work entirely offline. Optional update checks contact the release feed; Floatick collects zero telemetry.
- macOS 10.15 or later, or Omarchy with the dependencies in the setup guide
- Node.js 18+ and pnpm
- Rust (1.80+) and Cargo
# 1. Install dependencies
pnpm install
# 2. Start Tauri development server (with hot reload)
pnpm tauri:devOn macOS, the Tauri commands automatically download the pinned, checksum-verified Sparkle framework. Before running Cargo directly, run pnpm setup:sparkle once. The updater is available in a packaged .app; browser previews and unbundled tauri dev show an unavailable state. Build and launch the .app to test native update windows.
# Build Universal Binary DMG and .app bundle
pnpm tauri:buildThe output files will be created in src-tauri/target/release/bundle/macos/ and .../dmg/.
src/ # Frontend (React 19 + TypeScript + Vite + Tailwind CSS)
components/
common/ # TipTap editor, search bar, common UI components
layout/ # Header, ContentSwitcher, window frame
notes/ # Note list, note rows, note editor drawer
settings/ # Preferences drawer (theme, language, autostart)
tags/ # Tag management & filtering
todos/ # Todo list, item rows, deadline picker, editor drawer
stores/ # Zustand state management
i18n/ # Localization resources (English and Chinese)
lib/ # Tauri IPC API bindings
src-tauri/ # Native Backend (Rust + Tauri 2.x)
src/
tray.rs # macOS Menu Bar tray & magnetic window anchoring
storage.rs # Atomic JSON file persistence in ~/.floatick
commands.rs # IPC commands exposed to frontend
lib.rs # Window lifecycle & auto-dismiss on blur
website/ # Marketing website (Astro)
docs/ # Design specifications and architecture guides
Floatick is released under the MIT License.
