StickThat

A minimal, elegant sticky notes application for macOS built with Tauri.

Features

Core Functionality

• Multi-window sticky notes - Create unlimited independent notes
• Auto-save - Notes automatically persist with position, size, and content
• Clean interface - Frameless windows with no distractions
• Click anywhere to write - No buttons or controls cluttering the note

Checklist Mode

• Toggle with Cmd+Shift+L - Convert any note to a checklist
• Markdown format - Stored as - [ ] and - [x] for compatibility
• Smart paste - Paste markdown checklists and they render correctly
• Copy as markdown - Copy checklists and paste elsewhere as markdown
• Custom checkbox SVGs - Beautiful, scalable checkboxes
• Keyboard navigation - Arrow up/down to move between items
• Auto-create items - Press Enter to add new checklist items
• Click to check - Click checkboxes to toggle completion state

Customization

• 6 colors - Yellow, Green, Blue, Pink, Purple, Gray
• Adjustable font size - Cmd+= to increase, Cmd+- to decrease
• Preferences window - Cmd+, to access settings
• Always on top - Keep notes above all other windows
• Inactive window opacity - Set transparency for unfocused notes (10%-100%)

Workflow

• Spawn at cursor - New notes appear where your mouse is
• Save as markdown - Cmd+S to export notes as .md files
• Persistent state - All notes, colors, fonts, positions, and sizes remembered
• Native macOS menus - Full menu bar integration with standard shortcuts

Installation

Download

Download the latest release from the Releases page.

Build from Source

# Clone the repository
git clone https://github.com/Promises/StickThat.git
cd StickThat

# Install dependencies (requires Rust and Node.js)
cd src-tauri
cargo build --release

# Build the .app
cargo tauri build

The built app will be at src-tauri/target/release/bundle/macos/StickThat.app

Keyboard Shortcuts

File Operations

• Cmd+N - New note (spawns at mouse cursor)
• Cmd+W - Close current note
• Cmd+S - Save note as markdown
• Cmd+Q - Quit application
• Cmd+, - Open preferences

Editing

• Cmd+Z - Undo
• Cmd+Shift+Z - Redo
• Cmd+X - Cut
• Cmd+C - Copy (copies as markdown in checklist mode)
• Cmd+V - Paste (parses markdown checklists)
• Cmd+A - Select all

Formatting

• Cmd+Shift+L - Toggle checklist mode
• Cmd+= - Increase font size
• Cmd+- - Decrease font size

Checklist Mode

• Enter - Create new checklist item
• Backspace on empty item - Delete item
• Arrow Up/Down - Navigate between items
• Click checkbox - Toggle completion

Data Storage

Notes and preferences are stored at:

~/Library/Application Support/StickThat/
├── notes.json          # All note content and properties
└── preferences.json    # User preferences

Technology Stack

• Tauri 2 - Rust backend with HTML/CSS/JS frontend
• Rust - High-performance backend
• Native macOS APIs - Window transparency and cursor position via Cocoa
• No frameworks - Vanilla JavaScript for minimal footprint

Features in Detail

Checklist Mode

Toggle any note into a checklist with Cmd+Shift+L. Notes are stored in markdown format:

- [ ] Write the press release
- [x] Update the website
- [ ] Contact the media

This makes checklists compatible with any markdown editor.

Preferences

Access via Cmd+, or File → Preferences:

• Always on top - Keep notes floating above all windows
• Inactive window opacity - Adjust transparency for unfocused notes (great for seeing through notes to content below)

Changes apply in real-time. Click Save to keep them, Cancel to revert.

Color Themes

Choose from 6 colors via the Color menu:

• Yellow (default sticky note color)
• Green
• Blue
• Pink
• Purple
• Gray

Each note can have its own color.

AppleScript & Automation

StickThat includes programmatic automation support through Tauri commands. While traditional AppleScript object model support is in development, you can automate StickThat using:

• Tauri Commands - Direct API access for creating, modifying, and managing notes
• Keyboard Maestro - Create macros that control StickThat
• Alfred Workflows - Build custom workflows
• BetterTouchTool - Bind gestures to StickThat actions

Available automation commands:

• applescript_make_note - Create new notes with optional properties
• applescript_get_note - Retrieve note content and properties
• applescript_set_note_text - Update note text
• applescript_set_note_color - Change note colors
• applescript_toggle_checklist_for_note - Toggle checklist mode
• applescript_close_note - Close notes programmatically

See APPLESCRIPT.md for detailed documentation and examples.

Development

# Run in development mode
cd src-tauri
cargo tauri dev

# Build for production
cargo tauri build

License

MIT

Contributing

Contributions welcome! Please open an issue or pull request.