CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

Adheres to Semantic Versioning (MAJOR.MINOR.PATCH).

[Unreleased]

Added

Changed

Fixed

[0.9.1] - 2026-02-20

Added

• Password reset flow end-to-end:
  • POST /api/auth/forgot-password and POST /api/auth/reset-password
  • reset-link email support and reset-token handling in sign-in UI.
• Admin user-management password action (PATCH /api/admin/users/:id/password) and UI control for manual resets.

Changed

• User-management table/actions on mobile now use wrapped content instead of clipping/ellipsis for critical fields.
• Offline sync UX now uses a FontAwesome sync icon badge in note cards instead of the previous “Syncing…” text.
• Offline note sync indicators now cover queued offline edits/uploads (not only offline-created notes).
• Service worker navigation handling now prioritizes cached shell for resilient offline manual refresh, with background revalidation.

Fixed

• User-management stats aggregation issues that could report 0 note/image/DB usage despite existing data.
• Checklist completed-items collapsed/expanded flash on mobile/PWA refresh by initializing persisted state before first paint.
• Offline user preference changes (appearance/editor/card prefs) now queue and persist to server after reconnect.
• Notes cache fallback now allows offline reload/manual refresh recovery when IndexedDB is unavailable/slow.
• Notes grid now refreshes after offline queue flush so cards reflect reconciled server state after reconnect.

[0.9.0] - 2026-02-19

Added

• IndexedDB-backed Yjs local persistence (y-indexeddb) as the canonical local document store for editor rooms, including best-effort migration from legacy Dexie Yjs rows.
• Temporary note-open tracing in server startup/runtime (opt-in via TRACE_NOTE_OPEN) for diagnosing note-open HTTP + websocket/Yjs persistence flow.

Changed

• Rich text and checklist editors now follow a stricter local-first startup order:
  • bind local Y.Doc persistence first,
  • render from local state,
  • attach websocket sync non-blocking afterward.
• Offline temporary note reconciliation now migrates local Yjs persistence keys from temporary IDs to canonical server note room IDs.
• Mobile/PWA new-note create flow no longer blocks initial content seed on websocket sync event.

Fixed

• Eliminated editor content flicker/disappear on open caused by startup races between optimistic snapshots and early empty Yjs updates.
• Prevented open-time editor write calls by gating derived body/item persistence to local user-edit transactions.
• Fixed offline-created note behavior where note cards showed content but editors opened empty (desktop/mobile/PWA parity restored).
• Improved mobile/PWA resilience for offline/online transitions to reduce post-reconnect data loss scenarios.

[0.8.4] - 2026-02-18

Added

• Redis-backed reminder queue architecture using BullMQ (server/src/lib/queue.ts, server/src/workers/reminderWorker.ts, server/src/lib/redis.ts) with delayed jobs, retry/backoff, startup resync, and graceful shutdown handling.
• Optional Redis Pub/Sub bridge for cross-instance Yjs propagation (server/src/lib/yjsRedisBridge.ts) with instance tagging and rebroadcast loop prevention.
• New environment configuration for Redis and feature toggles in .env.example:
  • REDIS_HOST, REDIS_PORT, REDIS_PASSWORD
  • ENABLE_REMINDER_WORKER
  • ENABLE_REDIS_PUBSUB

Changed

• Server startup now initializes reminder queue state from DB and conditionally starts the in-process reminder worker in server/src/index.ts.
• Reminder scheduling flow moved from polling to queue-driven execution; note create/update/archive/trash/delete lifecycle paths now keep reminder jobs in sync (server/src/notes.ts).
• Reminder resync now includes pending due reminders (including past-due unsent reminders), improving restart/downtime recovery behavior.
• Legacy polling module server/src/reminderPushJob.ts is retained as a deprecated no-op compatibility shim.
• Release metadata/version bumped to 0.8.4.

Fixed

• Reduced unnecessary DB writes during note-card drag/layout and idle states:
  • deduplicated order persistence writes in client/src/components/NotesGrid.tsx,
  • disabled per-card realtime Yjs sessions in client/src/components/NoteCard.tsx (editor realtime remains active).
• Reduced Yjs persistence write pressure by debouncing DB snapshot writes in server/src/index.ts while preserving realtime websocket collaboration.
• Removed file-based Prisma DB event logging to db.log and restored normal environment-based Prisma log output in server/src/prismaClient.ts.

[0.8.3] - 2026-02-16

Added

• Mobile/PWA create-checklist toolbar parity improvements so B/I/U active states now correctly reflect empty-line stored marks during new-note creation.

Changed

• Desktop and mobile create editors now share richer mark-toggle behavior for line-scoped formatting (including empty-line stored-mark handling) and immediate toolbar pressed-state refresh.
• Mobile/PWA note-corner indicator sizing was increased for improved touch visibility.
• Mobile/PWA note-corner overlap layout was re-tuned to keep icons half-over-card while preserving vertical separation between stacked notes.
• Release metadata/version bumped to 0.8.3.

Fixed

• Checklist editor offline data-loss edge case where replace-all saves could use empty Yjs state and clear checklist rows.
• Notes grid offline load fallback no longer drops optimistic pending cards when network load fails and cache is unavailable.
• URL preview persistence hardened when unfurl scraping fails (server now stores a minimal fallback preview row).
• Desktop URL-preview add flow in rich-text editor no longer fails silently; optimistic preview appears immediately, direct online POST path is attempted first, and unexpected success payloads now trigger preview-list refresh fallback.
• URL modal interactions in create flow no longer trigger accidental editor close/dismiss.
• Create-checklist image attachment parity implemented for desktop and mobile create flows (dock/grid + remove actions).
• Create-editor image dock sizing now matches existing editor thumbnail behavior on desktop.
• Collaborator add flow parity restored between text and checklist editors, with server endpoint support for email or userId and idempotent existing-collaborator handling.
• Offline replay engine resilience:
  • queued mutations with invalid temp note IDs are dropped as non-retryable,
  • stale note-targeted 404 queued mutations are dropped,
  • invalid queued note-create 400 mutations are dropped,
  • queued child mutations/uploads are remapped from temp client note IDs to real server note IDs after reconciliation.
• Offline upload queue no longer repeatedly POSTs image uploads against negative temporary note IDs.
• Create-checklist B/I/U pressed/highlight behavior now matches text editor parity in desktop and mobile create surfaces.
• Wording and UI consistency updates:
  • destructive menu labels normalized to “Move to trash”,
  • note images modal close icon visibility fixed in light theme,
  • corner icon opacity/border polish aligned with note title background color.

[0.8.2] - 2026-02-16

Added

• Sticky inline-format toolbar behavior in editors: B, I, and U now remain active at empty cursor positions and apply to newly typed text.

Changed

• Split card/editor typography scoping now uses surface-specific effective CSS variables, keeping note-card and editor text metrics independent.
• Version bump and release packaging updates for 0.8.2.

Fixed

• Decoupled card text-size preference from editor text-size rendering.
• Restored editor line-spacing preference behavior where it could be ignored by shared fallback variables.
• Editor mark toggles now reliably clear stored formatting on empty lines/items when de-selected.
• Checklist toolbar active-state detection improved when focus temporarily shifts to toolbar controls.
• Added extra top clearance below sticky quick-create so top-row card corner icons (pin/reminder) are not clipped.

[0.8.1] - 2026-02-16

Added

• Authenticated note-image thumbnail endpoint (GET /api/notes/:id/images/:imageId/thumb) with Sharp resize/compression and on-disk cache reuse for faster editor/modal image grids.

Changed

• Editor image surfaces now request size-appropriate thumbnails (Rich Text editor, Checklist editor, and Note Images modal) instead of loading full-resolution originals in grid views.
• Checklist drag ghost rendering now reads live computed sizing values (gap, checkbox size, text size, line box height) from the dragged row for more faithful cross-device visuals.
• Note title strip was adjusted to provide dedicated top space for corner icons (pin/reminder/clear-reminder) while keeping title text visibility clear.

Fixed

• Offline reconciliation and preview rendering reliability for text notes: prevented transient empty-body overwrite after reconnect/refresh and improved fallback behavior when synced rich-text preview is temporarily empty.
• Offline URL-preview insertion now creates immediate placeholders in both Rich Text and Checklist editors while queued requests sync later.
• Checklist mobile close-path parity: mobile back action now runs the same prune/save/discard flow as the close button.
• Checklist drag target visuals now show a single clear orange outline (removed doubled inner/outer highlight conflict).
• Checklist control alignment consistency improvements across checkbox size/text size preferences, including active-row highlight centering and ghost alignment.
• Note card title overlap with corner indicators resolved by increasing title-strip top runway.

[0.8.0] - 2026-02-15

Added

• Built-in registration defaults for both user and device preferences, including hard-coded first-run defaults by device class (mobile, tablet, desktop).
• New offline-first client data layer under client/src/lib/offline:
  • local note cache,
  • mutation queue,
  • upload queue,
  • sync engine,
  • Dexie-backed persistence,
  • Yjs persistence helpers.
• Reminder completion quick-action in note cards and editors so reminders can be marked complete (cleared) in one tap/click.
• Desktop focus treatment for note More menus with selective context emphasis (origin note/editor remains focused while menu is open).

Changed

• Reminder UX polish across cards/list/editor views:
  • urgency classes standardized,
  • list-view bell coloring refined,
  • improved reminder update propagation while repeatedly editing due dates.
• List layouts (single and two-column) substantially refined for desktop, narrow desktop, and mobile/PWA:
  • improved title/meta/action spacing,
  • better chip placement,
  • cleaner dock/footer behavior,
  • better card-height handling at narrower widths.
• Editor More menus now include pin/unpin actions (including unpin for already pinned notes).
• Increased visual separation between pinned and unpinned note sections.
• More-menu presentation refresh:
  • desktop popup sizing and readability tweaks,
  • hidden desktop scrollbars,
  • stronger mobile/PWA drag/drop visual feedback around menu-related interactions.
• Push/notification resilience improvements and diagnostics flow updates across client/server.

Fixed

• Mobile/PWA note reorder in list mode:
  • removed stray reminder chip appearing in drag overlays,
  • improved drop-target highlight visibility.
• Android/Chrome left-edge conflict where browser back-swipe could block sidebar open gesture; sidebar swipe now consistently wins in mobile/PWA contexts.
• Reminder urgency edge-case behavior around short-term dates (today/tomorrow/2–14 day ranges).
• Multiple UX regressions around note drag state, click-away handling, and More menu interaction lock timing.

[0.7.3] - 2026-02-15

Added

• Due-date indicator pill on note cards for reminders, now shown across all card views with relative labels (for example: Due today / Due tomorrow / Overdue).
• Urgency color coding for reminder indicators: red (today/tomorrow/overdue), orange (3–7 days), yellow (1–2 weeks).
• Firefox-friendly Preferences support for PWA install: “Install app” is now shown with manual install guidance when native install prompt APIs are unavailable.

Changed

• Header/profile avatars and registration/appearance photo previews now use rounded-square corners for consistent icon language.
• Header avatar sizing was normalized to 34×34 to match adjacent header icon controls.
• Mobile/tablet/PWA Images view spacing increased between active filter chips and gallery content for improved touch readability.
• Mobile FAB theme tokenization now keeps the same FAB color in both dark and light themes.
• Mobile/PWA typography normalization pass to reduce Chrome/Firefox rendering drift (root scaling/adjustment and inherited control typography).

Fixed

• Due indicator placement no longer collides with note titles; indicator is rendered in a readable inline position below the title strip.
• Smart filter wiring in sidebar/notes grid updated so “Due soon”, “Least accessed”, and “Most edited” behaviors are fully active and clearable.

[0.7.2] - 2026-02-15

Added

• Sidebar Images mode now includes a persistent image-size slider (saved in local storage) with responsive behavior across desktop/mobile/PWA.
• Image cards can open their associated note directly from the title in Images view.
• Touch-first Images UX now supports long-press delete (mobile/tablet/PWA) with movement guard to reduce accidental deletes.

Changed

• Images view polish: removed owner/date subtitle metadata from image cards and tightened touch card spacing/chrome.
• Desktop now hides note quick-create controls while Images view is active; mobile/PWA/tablet create flows from Images automatically return to Notes view.
• Header view-toggle button is hidden while Images view is active to avoid changing hidden note-list modes.

Fixed

• React hook-order crashes in NotesGrid (Rendered more hooks than during previous render) by stabilizing hook call order.
• Realtime event reliability on unstable/mobile networks: /events websocket now reconnects with backoff and resyncs on reconnect/online/visibility.
• OCR search reliability: normalized client-side search matching for OCR text (Unicode/diacritics/punctuation/whitespace) and added OCR in-flight fallback refresh polling when realtime OCR completion events are missed.
• Restored desktop spacing in list views (list-1/list-2) while preserving compact touch/mobile layout.

[0.7.1] - 2026-02-15

Changed

• Migrated runtime database setup and container defaults to PostgreSQL (pg) with updated bootstrap/setup scripts and Docker wiring.
• Mobile/FAB create flows now use the same editor scroll-shell structure and title/body width behavior as existing-note editors.
• MobileCreateModal rich-text toolbar now matches the existing note editor order and controls (including link placement and justify alignment).
• Tightened more-menu sizing and spacing across desktop and mobile/PWA for denser, easier-to-scan actions.

Fixed

• Auth session persistence after server restarts: returning users are no longer incorrectly prompted to log in when /api/auth/me is valid.
• Mobile note-card gesture conflicts: long-press menu vs drag activation, sidebar swipe interference during drag, and background drag while menu is open.
• Mobile long-press/menu interactions on Android no longer trigger unwanted text-selection/callout behavior.
• Note-card image picker now supports selecting and attaching multiple images in one action (desktop/mobile/PWA).
• Checklist mobile drag intent tuning: improved vertical reorder pickup and reduced accidental horizontal indent actions.
• Mobile create/edit parity fixes for focus rings, title-missing highlighting, and bottom typing runway near sticky/footer controls.

[0.6.9] - 2026-02-14

Changed

• Refined header controls and icon styling for better visual consistency (menu button now matches view-toggle theme).
• Mobile/PWA search placement was moved into the sticky strip for improved reachability.
• Desktop quick-create sticky strip was tightened and aligned flush under the header with a solid background.

Fixed

• Note reordering can now be started from note content areas more reliably across desktop and touch devices.
• Desktop checklist-preview checkboxes are interactive again, while mobile/PWA card toggles remain intentionally disabled.
• Checklist editors now clear active caret/selection/highlight state when toggling item checkboxes.
• Improved checklist row alignment on mobile/PWA editors (drag handle, checkbox, and text baseline).

[0.6.7] - 2026-02-14

Changed

• Added a 3-state view cycle in the header: card view, 1x1 list view, and 2x1 list view.
• Refined list layouts to use a title-first header with compact metadata chips and hover-revealed action icons.
• Updated drag previews in list modes to show only the visible title row while reordering.

Fixed

• List views no longer show note body previews or leave empty white space under titles.
• Image preview expansion now chooses up/down direction based on available viewport space and image count, improving visibility near the top of the screen.
• Expanded image popups now render above neighboring cards via elevated stacking.
• Docker startup no longer fails on Prisma runtime regeneration permissions (EACCES) when running with PUID/PGID; production startup now safely uses build-time generated Prisma client by default.

[0.6.6] - 2026-02-13

Added

• Admin User Management now shows per-user usage stats: note count, image count, database usage, filesystem usage, and total storage.
• Optional Unraid-style container environment support: PUID, PGID, and UMASK.

Changed

• User Management layout was refined for mobile so usage stats remain readable on narrow screens.
• Docker runtime now supports optional uid/gid privilege drop at startup (via gosu) for bind-mounted shares.

Fixed

• Editor image dock behavior across note/checklist editors: the Images toggle stays fixed at the bottom while expanded images reveal upward and editor body space shrinks/expands accordingly.

[0.6.3] - 2026-02-10

Added

• Note cards now show a "+N images" chip by default; click to expand/collapse image thumbnails.
• Per-note image preview expansion preference persists per user across devices and updates in realtime across connected clients.

Fixed

• NoteCard collaborator/label/collection dropdowns now collapse immediately after selecting an item.
• Take-note checklist: desktop drag handle reliably starts drag, drag visuals are stable, vertical/horizontal direction locking supports indent, and link insertion no longer triggers click-away close.

[0.6.2] - 2026-02-10

Added

• Mobile/PWA: long-press on a note card body opens the More menu.

[0.6.1] - 2026-02-10

Fixed

• User profile photos/avatars now persist across container updates (uploads directory configurable via UPLOADS_DIR; Docker Compose mounts a persistent uploads volume).

[0.6.0] - 2026-02-10

Added

• OCR pipeline for note images (PaddleOCR runner + preprocessing) with persisted OCR text/metadata on NoteImage.
• Async server-side OCR queue with SHA-256 dedupe across identical images.

Fixed

• Enforced checklist empty-item pruning across create + edit editors.
• Notes/checklists cleared to an empty state are discarded instead of being saved.
• PWA swipe-right gesture now reliably opens the sidebar.
• Dev startup no longer errors due to missing database-url helper script.

[0.5.2] - 2026-02-10

Added

• Per-device preferences for editor and note-card behavior (stored under device profile when device headers are present).

Changed

• Note creation and editing UX refinements across desktop and mobile (create modal/flows, note-card interactions, and grid behavior).

Fixed

• Trash menus now match across all devices and editors: trashed notes show Restore + Delete permanently.
• Enforced rule: trashed notes can’t be archived (UI guard + server-side conflict response).
• Checklists automatically prune empty-text items on save/close (client-side Yjs + server-side filtering on create/sync).

[0.5.1] - 2026-02-09

Fixed

• Docker/GitHub build: npm ci no longer fails when the repository hasn’t copied prisma/schema.prisma yet (postinstall now skips Prisma steps until schema exists).

[0.5.0] - 2026-02-08

Added

• Web Push notifications for reminders (Android-friendly background delivery).
• Service worker push + notificationclick handling.
• Notifications settings UI: enable permission/subscription, local test, server push test.
• Link previews stored per-note (multiple previews per note) with realtime updates.

Changed

• In-app reminder notifications prefer service-worker showNotification() with a fallback to new Notification().

Fixed

• Mobile image and menu UX (bottom-sheet picker, long-press actions, in-app confirm dialog).
• Collapsed desktop sidebar icons now expand and perform their actions.

[0.4.6] - 2026-02-08

Added

• Always-visible active view chips (collection path, labels, collaborator, search, sort, grouping, smart filter) with per-chip clear and a global clear-all.
• Create-into-collection flow: when a collection filter path is active, new notes/checklists can be auto-added to the current collection on Save (toggle in the create UI).
• Mobile fullscreen create modals for note + checklist with Save-only persistence.

Changed

• Mobile Collections navigation no longer auto-closes the drawer when drilling into a collection.

Fixed

• Desktop TakeNoteBar click-away behavior so it doesn't immediately close on open.
• Mobile checklist drag behavior (handle/spacing/ghosting) to better match the main checklist editor.

[0.4.2] - 2026-02-05

Added

• Sidebar sorting + grouping controls (sort mode, group mode, and quick resets).
• Real-time note lifecycle events over /events: broadcast note-created and note-deleted so multiple sessions/collaborators stay in sync.
• Real-time image refresh across clients: broadcast note-images-changed and fetch the latest images via GET /api/notes/:id/images.

Changed

• Default ordering behavior: notes remain stable in creation order unless manually reordered.
• Sorting pipeline: layered sort → optional grouping while preserving manual ord as the baseline for Default mode.
• /events websocket now uses wss:// automatically when the app is served over HTTPS.

Fixed

• New labels become immediately filterable without requiring refresh.
• Images added/removed show up immediately in editors and note cards (optimistic UI + reconciliation).
• Note card body clipping when images are present.

UI

• Note card thumbnails: compact, wrap layout with “+N more” overflow indicator.
• Editor images moved to a bottom, collapsible section with a scroll cap for large sets.

[0.3.0] - 2026-02-01

Added

• Preferences hub with submenus: Appearance, Colors, Drag & Animation, Collaborators.
• User profile photos: client upload (data URL) → server resize/compress via Sharp → stored under /uploads/users/{id}.jpg and served statically.
• Real-time photo propagation: broadcast user-photo-updated to note participants; clients update owner/collab images inline.
• Collaborator chips display preference (chipDisplayMode): persisted per-user; rendering honors Image + Text | Image only | Text only.
• Per-user note color via NotePref and viewerColor; GET /api/notes includes viewer-specific color.
• Events channel updates: note-shared, note-unshared, collab-removed, user-photo-updated; NotesGrid subscribes for immediate UI refresh.

Changed

• Preferences consolidated into submenus; Save applies changes immediately (chip display mode via authContext.updateMe).
• Header simplified: avatar opens Preferences; Sign out moved into Preferences.
• Header avatar and Preferences preview standardized to 55×55.
• Collaborators section label updated from "Collaborator Chips" to "Collaborators".

Fixed

• Collaborator chips persist across refresh; rollback on failure.
• First opener of checklist sees live changes (Yjs gating fixed).
• Immediate photo refresh via cache-busting query ?v=timestamp appended to userImageUrl post-upload.

Removed

• Legacy OCR implementation: tesseract code, env vars, and references removed.

[0.2.0] - 2026-01-31

Collaboration & Live Updates

• Adopt Yjs as the canonical collaborative state for notes.
• Server-authoritative Y.Doc lifecycle: initialize from DB, persist snapshots on every update.
• WebSocket collaboration endpoint (/collab) for real-time sync across clients.
• Integrity diagnostics endpoint: GET /api/notes/:id/integrity compares DB vs Y.Doc; supports ?token in dev.

Text Notes

• Stop storing HTML for text notes; keep TipTap JSON and derive sanitized previews.
• Headless TipTap Editor bound to Y.Doc computes live HTML previews on NoteCard.

Checklist Collaboration

• CRDT model: Y.Array<Y.Map> for checklist items with content, checked, indent, and stable uid keys.
• Operations for add/edit/toggle/move/indent with server-persisted order.
• Live NoteCard updates reflect Yjs changes immediately.

Drag & UX Improvements

• Restore smooth vertical drag animation: neighbors shift up/down with eased transforms.
• Fix nested drag mis-selection when dragging across unchecked/checked groups.
• Increase drag handle hit area for easier grabbing.

Stability & Dev Experience

• Debounced preview sync for text notes; Windows start uses cross-env.

• Minor UI polish: checklist alignment, paragraph margin resets, Underline restored.

[0.2.1] - 2026-01-31

Changed

• CI: Docker workflow now publishes semver tags without the leading v (e.g., 0.2.1, 0.2) in addition to v0.2.1.
• No code changes.

[0.1.0] - 2026-01-28

• Initial public commit of FreemanNotes
• Core features: responsive notes grid, drag-to-reorder, user preferences, invites, and updated README

Template for future releases

Added

Changed

Fixed

Removed

Security