floatnote 1.0.0

package/.beads/config.json

@@ -0,0 +1,6 @@
+{
+  "prefix": "floatnote",
+  "nextId": 21,
+  "created": "2026-01-15T09:12:00.000Z",
+  "version": "1.0.0"
+}

package/.beads/issues/floatnote-1.md

@@ -0,0 +1,21 @@
+# floatnote-1: Set up testing infrastructure
+
+**Status:** closed
+**Priority:** high
+**Labels:** infrastructure, testing
+
+## Description
+Set up Jest and Electron testing infrastructure for the Floatnote project.
+
+## Tasks
+- [ ] Install Jest and testing dependencies
+- [ ] Configure Jest for Electron (main + renderer)
+- [ ] Set up test directory structure
+- [ ] Add test scripts to package.json
+- [ ] Configure code coverage reporting
+- [ ] Set up mock for Electron APIs
+
+## Acceptance Criteria
+- `npm test` runs all tests
+- `npm run test:coverage` shows coverage report
+- Tests can run in CI environment

package/.beads/issues/floatnote-10.md

@@ -0,0 +1,28 @@
+# floatnote-10: Test renderer - Clipboard and paste
+
+**Status:** open
+**Priority:** medium
+**Labels:** testing, renderer, clipboard
+**Depends:** floatnote-1
+
+## Description
+Test coverage for clipboard and paste functionality.
+
+## Functions to Test
+- `setupClipboardPaste()` - Paste event handler
+- `paste()` - Handle paste action
+- `pasteImage()` - Paste image from clipboard
+- `pasteText()` - Paste text from clipboard
+- `setupImageResize()` - Image resize handles
+
+## Test Cases
+- [ ] Cmd+V triggers paste
+- [ ] Paste detects image content
+- [ ] Paste detects text content
+- [ ] Pasted image creates DOM element
+- [ ] Pasted image positioned correctly
+- [ ] Pasted image can be dragged
+- [ ] Pasted image can be resized
+- [ ] Pasted text creates text item
+- [ ] Images saved to images array
+- [ ] Restored images match saved data

package/.beads/issues/floatnote-11.md

@@ -0,0 +1,36 @@
+# floatnote-11: Test renderer - Settings and persistence
+
+**Status:** open
+**Priority:** medium
+**Labels:** testing, renderer, settings
+**Depends:** floatnote-1
+
+## Description
+Test coverage for settings panel and data persistence.
+
+## Functions to Test
+- `setupSettings()` - Settings panel setup
+- `toggleSettings()` - Show/hide panel
+- `hideSettings()` / `showSettings()`
+- `saveData()` - Persist all data
+- `loadSavedData()` - Restore saved data
+- `autoSave()` - Debounced save
+
+## Test Cases
+### Settings Panel
+- [ ] Cmd+, opens settings
+- [ ] Close button hides settings
+- [ ] Escape key hides settings
+- [ ] Click outside hides settings
+- [ ] Toggle changes update settings object
+- [ ] Background mode changes apply
+
+### Persistence
+- [ ] saveData includes all notes
+- [ ] saveData includes settings
+- [ ] saveData includes transform
+- [ ] loadSavedData restores notes
+- [ ] loadSavedData restores settings
+- [ ] loadSavedData handles legacy format
+- [ ] Clean slate setting creates new note
+- [ ] autoSave debounces multiple calls

package/.beads/issues/floatnote-12.md

@@ -0,0 +1,25 @@
+# floatnote-12: Test renderer - Context menu
+
+**Status:** open
+**Priority:** low
+**Labels:** testing, renderer, ui
+**Depends:** floatnote-1
+
+## Description
+Test coverage for right-click context menus.
+
+## Functions to Test
+- `setupContextMenu()` - Context menu setup
+- `showContextMenu()` - Display menu at position
+- `hideContextMenu()` - Hide menu
+
+## Test Cases
+- [ ] Right-click on canvas shows general menu
+- [ ] Right-click on object shows object menu
+- [ ] General menu has zoom options
+- [ ] General menu has settings option
+- [ ] Object menu has copy option
+- [ ] Object menu has delete option
+- [ ] Menu positioned at click location
+- [ ] Click elsewhere hides menu
+- [ ] Menu actions trigger correct functions

package/.beads/issues/floatnote-13.md

@@ -0,0 +1,37 @@
+# floatnote-13: Test preload.js IPC bridge
+
+**Status:** open
+**Priority:** medium
+**Labels:** testing, preload, ipc
+**Depends:** floatnote-1
+
+## Description
+Test coverage for the preload script IPC bridge.
+
+## Functions to Test
+- `onFocusChange()` - Focus event listener
+- `closeWindow()` - Close IPC
+- `hideWindow()` - Hide IPC
+- `setPinned()` - Pin state IPC
+- `setWindowSize()` - Size IPC
+- `setBackgroundMode()` - Background IPC
+- `getClipboardContent()` - Read clipboard
+- `readClipboardImage()` - Read image
+- `readClipboardText()` - Read text
+- `saveData()` - Save IPC
+- `loadData()` - Load IPC
+- `resizeWindowLeft()` - Resize IPC
+
+## Test Cases
+- [ ] onFocusChange registers callback
+- [ ] closeWindow sends correct IPC
+- [ ] hideWindow sends correct IPC
+- [ ] setPinned sends boolean value
+- [ ] setWindowSize sends size string
+- [ ] setBackgroundMode sends mode string
+- [ ] getClipboardContent returns image data
+- [ ] getClipboardContent returns text data
+- [ ] getClipboardContent returns null if empty
+- [ ] saveData invokes IPC handler
+- [ ] loadData invokes IPC handler
+- [ ] resizeWindowLeft sends delta value

package/.beads/issues/floatnote-14.md

@@ -0,0 +1,22 @@
+# floatnote-14: Multi-select with drag box
+
+**Status:** closed
+**Priority:** high
+**Labels:** feature, selection
+
+## Description
+Allow users to click-hold-drag with the select tool to draw a selection rectangle and select all objects within it.
+
+## Requirements
+- In select mode, click and drag creates a selection rectangle
+- All objects (drawings, text, images) within the rectangle are selected
+- Visual feedback showing the selection rectangle while dragging
+- Selected objects highlighted with selection indicator
+- Works with existing selection (shift to add to selection?)
+
+## Implementation
+- Add `selectionRect` state for drag selection
+- Track mousedown position as start point
+- Draw selection rectangle overlay during drag
+- On mouseup, find all objects intersecting rectangle
+- Add to `selectedObjects` array

package/.beads/issues/floatnote-15.md

@@ -0,0 +1,22 @@
+# floatnote-15: Note pagination UI island
+
+**Status:** closed
+**Priority:** high
+**Labels:** feature, ui
+
+## Description
+Add a visible pagination control island showing prev/next buttons and current page number. Pinned to the right side, follows same visibility rules as toolbar.
+
+## Requirements
+- Island pinned to right side of screen
+- Shows: [<] [1/5] [>] style controls
+- Same show/hide rules as toolbar (visible on hover/focus)
+- Click < for previous note
+- Click > for next note
+- Page number shows current/total
+
+## Implementation
+- Add `#pagination-island` element to HTML
+- Style similar to other control islands
+- Wire up to previousNote/nextNote functions
+- Update display when notes change

package/.beads/issues/floatnote-16.md

@@ -0,0 +1,20 @@
+# floatnote-16: Inactive background options
+
+**Status:** closed
+**Priority:** medium
+**Labels:** feature, appearance
+
+## Description
+Allow choosing a background style for when the window is not focused (inactive). Same options as active: transparent, blur, dark.
+
+## Requirements
+- Settings panel has "Active background" and "Inactive background" sections
+- Same three options: Clear, Blur, Dark
+- Window switches between backgrounds on focus/blur events
+- Persisted in settings
+
+## Implementation
+- Add `inactiveBgMode` to settings
+- Add UI controls in settings panel
+- Update focus/blur handlers to switch background
+- Call setBackgroundMode with appropriate mode

package/.beads/issues/floatnote-17.md

@@ -0,0 +1,20 @@
+# floatnote-17: Background opacity controls
+
+**Status:** closed
+**Priority:** medium
+**Labels:** feature, appearance
+
+## Description
+Allow setting opacity for both active and inactive backgrounds.
+
+## Requirements
+- Opacity slider (0-100%) for active background
+- Opacity slider (0-100%) for inactive background
+- Real-time preview as slider moves
+- Persisted in settings
+
+## Implementation
+- Add `activeBgOpacity` and `inactiveBgOpacity` to settings
+- Add range sliders to settings panel
+- Apply opacity via CSS or window opacity
+- Update on focus/blur events

package/.beads/issues/floatnote-18.md

@@ -0,0 +1,21 @@
+# floatnote-18: Auto-save notes to ~/.floatnote folder
+
+**Status:** closed
+**Priority:** medium
+**Labels:** feature, storage
+
+## Description
+Add a setting to automatically save notes to ~/.floatnote folder for backup and external access.
+
+## Requirements
+- Toggle setting: "Auto-save notes to ~/.floatnote"
+- On save, write note JSON to `~/.floatnote/note-{id}.json`
+- Create directory if it doesn't exist
+- Only save when setting is enabled
+
+## Implementation
+- Add `autoSaveToFolder` setting
+- Add IPC handler `export-to-floatnote` in main.js
+- Add preload bridge function
+- Add toggle in settings UI
+- Call export on each autoSave() if enabled

package/.beads/issues/floatnote-19.md

@@ -0,0 +1,19 @@
+# floatnote-19: Open notes folder in Finder
+
+**Status:** closed
+**Priority:** medium
+**Labels:** feature, ui
+
+## Description
+Add a button in settings to open the ~/.floatnote folder in Finder.
+
+## Requirements
+- Button: "Open Notes Folder" in settings panel
+- Opens ~/.floatnote in Finder
+- Creates folder if it doesn't exist
+
+## Implementation
+- Add IPC handler `open-floatnote-folder` in main.js
+- Use shell.openPath() from Electron
+- Add preload bridge function
+- Add button in settings UI

package/.beads/issues/floatnote-2.md

@@ -0,0 +1,32 @@
+# floatnote-2: Test CLI entry point (bin/floatnote.js)
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, cli
+**Depends:** floatnote-1
+
+## Description
+100% test coverage for the CLI entry point that downloads and launches the app.
+
+## Functions to Test
+- `getLatestRelease()` - GitHub API call
+- `downloadFile()` - File download with redirects
+- `formatBytes()` - Byte formatting utility
+- `main()` - CLI argument handling
+
+## Test Cases
+- [ ] --version flag shows version
+- [ ] --help flag shows help text
+- [ ] --uninstall removes app directory
+- [ ] --update forces download
+- [ ] Handles missing releases gracefully
+- [ ] Handles download failures
+- [ ] Handles redirect responses (301, 302)
+- [ ] Creates app directory if missing
+- [ ] Launches app after download
+- [ ] Skips download if version matches
+
+## Mocks Required
+- https module (GitHub API, downloads)
+- fs module (file operations)
+- child_process (spawn for app launch)

package/.beads/issues/floatnote-20.md

@@ -0,0 +1,22 @@
+# floatnote-20: Export note as PNG with Cmd+S
+
+**Status:** closed
+**Priority:** high
+**Labels:** feature, export
+
+## Description
+Map Cmd+S to export the current note as a flattened PNG image.
+
+## Requirements
+- Cmd+S opens save dialog
+- Export canvas + text + images as PNG
+- User chooses destination
+- Flatten all layers to single image
+
+## Implementation
+- Add Cmd+S handler in setupKeyboardShortcuts()
+- Create exportAsPNG() method
+- Use canvas.toDataURL() for drawing
+- Render text and images to canvas before export
+- Add IPC handler `export-png` with dialog.showSaveDialog()
+- Add preload bridge function

package/.beads/issues/floatnote-3.md

@@ -0,0 +1,50 @@
+# floatnote-3: Test main process (src/main.js)
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, electron, main-process
+**Depends:** floatnote-1
+
+## Description
+100% test coverage for the Electron main process.
+
+## Functions to Test
+- `createWindow()` - Window creation and configuration
+- `createTray()` - Tray icon and menu setup
+- `toggleFloatnote()` - Show/hide window
+- IPC handlers (save-data, load-data, set-pinned, etc.)
+
+## Test Cases
+### Window Management
+- [ ] Creates window with correct dimensions
+- [ ] Window is transparent and always-on-top
+- [ ] Window positioned on correct display
+- [ ] Single instance lock works
+- [ ] Second instance focuses existing window
+- [ ] Close confirmation dialog works
+- [ ] Hide window handler works
+
+### Tray
+- [ ] Tray icon created with correct image
+- [ ] Tray tooltip shows "Floatnote"
+- [ ] Context menu has all items
+- [ ] Left-click shows/focuses window
+- [ ] Right-click shows context menu
+
+### IPC Handlers
+- [ ] save-data writes to file
+- [ ] load-data reads from file
+- [ ] set-pinned updates always-on-top
+- [ ] set-window-size resizes correctly
+- [ ] set-background-mode changes vibrancy
+- [ ] resize-window-left adjusts bounds
+- [ ] hide-window hides window
+
+### Global Shortcuts
+- [ ] Cmd+Shift+G toggles window
+- [ ] Alt+Space toggles window
+- [ ] Ctrl+\` toggles window
+
+## Mocks Required
+- Electron modules (BrowserWindow, Tray, Menu, etc.)
+- fs module for data persistence

package/.beads/issues/floatnote-4.md

@@ -0,0 +1,31 @@
+# floatnote-4: Test renderer - Drawing functionality
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, renderer, drawing
+**Depends:** floatnote-1
+
+## Description
+Test coverage for canvas drawing functionality in renderer.js.
+
+## Functions to Test
+- `setupCanvas()` - Canvas initialization
+- `setupDrawing()` - Mouse event handlers
+- `startDrawing()` - Begin stroke
+- `draw()` - Continue stroke
+- `stopDrawing()` - End stroke
+- `drawLine()` - Render line to canvas
+- `redraw()` - Full canvas redraw
+- `smoothLine()` - Line smoothing algorithm
+
+## Test Cases
+- [ ] Canvas resizes to window dimensions
+- [ ] Mouse down starts drawing in draw mode
+- [ ] Mouse move creates points
+- [ ] Mouse up ends stroke and saves line
+- [ ] Lines grouped by objectId within timeout
+- [ ] Drawing respects current color
+- [ ] Drawing respects current stroke width
+- [ ] Redraw renders all saved lines
+- [ ] Line smoothing reduces point count
+- [ ] Drawing disabled in select/text mode

package/.beads/issues/floatnote-5.md

@@ -0,0 +1,28 @@
+# floatnote-5: Test renderer - Text mode functionality
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, renderer, text
+**Depends:** floatnote-1
+
+## Description
+Test coverage for text annotation functionality.
+
+## Functions to Test
+- `setupTextMode()` - Text mode initialization
+- `createTextItem()` - Create new text element
+- `restoreTextItem()` - Restore text from saved data
+- `setupTextDrag()` - Dragging text items
+- `setupTextResize()` - Resizing text items
+
+## Test Cases
+- [ ] Click in text mode creates text item
+- [ ] Text item positioned at click location
+- [ ] Text item has editable contenteditable
+- [ ] Text uses current color
+- [ ] Text item can be dragged
+- [ ] Text item can be resized
+- [ ] Empty text items are removed on blur
+- [ ] Text items saved to textItems array
+- [ ] Restored text items match saved data
+- [ ] Selected text item has visual indicator

package/.beads/issues/floatnote-6.md

@@ -0,0 +1,30 @@
+# floatnote-6: Test renderer - Select mode and object manipulation
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, renderer, selection
+**Depends:** floatnote-1
+
+## Description
+Test coverage for selection and object manipulation.
+
+## Functions to Test
+- `selectObject()` - Select drawing object
+- `deselectObject()` - Clear selection
+- `findObjectAtPoint()` - Hit testing
+- `deleteObject()` - Delete selected object
+- `copyObject()` - Copy to clipboard
+- `selectAll()` - Select all objects
+- `deleteSelected()` - Bulk delete
+
+## Test Cases
+- [ ] Click on object selects it
+- [ ] Click elsewhere deselects
+- [ ] Selection highlight renders correctly
+- [ ] Hit testing finds correct object
+- [ ] Delete removes object from lines array
+- [ ] Copy stores object in clipboard
+- [ ] Cmd+A selects all objects
+- [ ] D key deletes selected
+- [ ] Bulk delete removes multiple objects
+- [ ] Selection state persists across redraws

package/.beads/issues/floatnote-7.md

@@ -0,0 +1,38 @@
+# floatnote-7: Test renderer - Zoom, pan, and gestures
+
+**Status:** open
+**Priority:** medium
+**Labels:** testing, renderer, gestures
+**Depends:** floatnote-1
+
+## Description
+Test coverage for zoom, pan, rotation and gesture handling.
+
+## Functions to Test
+- `setupZoom()` - Zoom controls setup
+- `setupGestures()` - Trackpad gesture handlers
+- `zoomIn()` / `zoomOut()` - Zoom operations
+- `resetZoom()` - Reset to 100%
+- `applyTransform()` - Apply CSS transforms
+
+## Test Cases
+### Zoom
+- [ ] Zoom in increases zoomLevel
+- [ ] Zoom out decreases zoomLevel
+- [ ] Zoom respects min/max bounds
+- [ ] Reset zoom sets to 1.0
+- [ ] Cmd++ zooms in
+- [ ] Cmd+- zooms out
+- [ ] Cmd+0 resets zoom
+
+### Pan
+- [ ] Two-finger pan updates panX/panY
+- [ ] Pan disabled when setting is off
+
+### Rotation
+- [ ] Rotation gesture updates rotation
+- [ ] Rotation disabled when setting is off
+
+### Transforms
+- [ ] applyTransform sets correct CSS
+- [ ] Transform includes zoom, pan, rotation

package/.beads/issues/floatnote-8.md

@@ -0,0 +1,29 @@
+# floatnote-8: Test renderer - Undo/redo and history
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, renderer, history
+**Depends:** floatnote-1
+
+## Description
+Test coverage for undo/redo functionality.
+
+## Functions to Test
+- `saveState()` - Save current state to history
+- `undo()` - Restore previous state
+- `redo()` - Restore next state
+- `restoreState()` - Apply state from history
+
+## Test Cases
+- [ ] saveState adds to history array
+- [ ] History limited to maxHistorySize
+- [ ] Undo decrements historyIndex
+- [ ] Undo restores previous lines
+- [ ] Undo restores previous textItems
+- [ ] Redo increments historyIndex
+- [ ] Redo restores next state
+- [ ] Redo unavailable at latest state
+- [ ] Undo unavailable at oldest state
+- [ ] Cmd+Z triggers undo
+- [ ] Cmd+Shift+Z triggers redo
+- [ ] New action clears redo stack

package/.beads/issues/floatnote-9.md

@@ -0,0 +1,32 @@
+# floatnote-9: Test renderer - Multi-note system
+
+**Status:** open
+**Priority:** high
+**Labels:** testing, renderer, notes
+**Depends:** floatnote-1
+
+## Description
+Test coverage for multi-note navigation system.
+
+## Functions to Test
+- `createEmptyNote()` - Create blank note
+- `previousNote()` - Navigate backward
+- `nextNote()` - Navigate forward or create new
+- `saveCurrentNoteState()` - Save before switch
+- `loadCurrentNote()` - Load note content
+- `clearDisplay()` - Clear current display
+- `updateNoteIndicator()` - Show note position
+
+## Test Cases
+- [ ] createEmptyNote has correct structure
+- [ ] previousNote decrements currentNoteIndex
+- [ ] previousNote does nothing at index 0
+- [ ] nextNote increments if more notes exist
+- [ ] nextNote creates new note at end
+- [ ] loadCurrentNote restores lines
+- [ ] loadCurrentNote restores textItems
+- [ ] loadCurrentNote restores images
+- [ ] clearDisplay removes text elements
+- [ ] Note indicator shows correct position
+- [ ] [ key goes to previous note
+- [ ] ] key goes to next note

package/CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Floatnote is a transparent always-on-top drawing and note-taking overlay for macOS, built with Electron. It provides a floating canvas that stays above all other windows for annotations, drawing, and text notes.
+
+## Commands
+
+```bash
+npm start          # Run the app
+npm run dev        # Run with logging enabled
+npm run build      # Build distributable (electron-builder)
+npm test           # Run all tests
+npm run test:watch # Run tests in watch mode
+npm run test:coverage # Run tests with coverage report
+```
+
+Run a single test file:
+```bash
+npx jest tests/renderer/notes.test.js
+```
+
+Run tests for a specific project (main, renderer, cli, preload):
+```bash
+npx jest --selectProjects=renderer
+```
+
+## Architecture
+
+### Electron Process Model
+
+- **Main process** (`src/main.js`): Window management, global shortcuts, IPC handlers, tray menu, data persistence. Single-window architecture with `requestSingleInstanceLock()`.
+
+- **Preload** (`src/preload.js`): Exposes `window.glassboard` API via contextBridge. Handles IPC communication, clipboard access, and file operations.
+
+- **Renderer** (`src/renderer.js`): The `Glassboard` class manages the entire UI - canvas drawing, text overlays, multi-note system, gestures, undo/redo, and settings.
+
+### Key Data Structures
+
+Notes are stored as objects with `lines`, `textItems`, `images`, and `attachments` arrays. The current note is accessed via getters that delegate to `this.notes[this.currentNoteIndex]`.
+
+Data persists to `~/.config/floatnote/floatnote-data.json` (via Electron's userData path). Notes can also be exported to `~/.floatnote/`.
+
+### IPC Communication
+
+Main ↔ Renderer communication uses named channels:
+- `close-window`, `hide-window`, `set-pinned`, `set-window-size`, `set-background-mode` (send)
+- `save-data`, `load-data`, `export-to-floatnote`, `export-png` (invoke/handle)
+- `window-focus`, `background-mode-changed`, `window-toggled-open` (events to renderer)
+
+### Testing
+
+Jest with separate projects for different contexts:
+- `main`: Uses electron mock (`tests/mocks/electron.js`)
+- `renderer`: Uses jsdom environment
+- `preload`: Uses electron mock
+- `cli`: Node environment for CLI tests
+
+The electron mock simulates BrowserWindow, app, globalShortcut, and other Electron APIs.