Skip to content

Beta Testing

Jump to bottom
Kenneth LaCroix edited this page Apr 13, 2026 · 1 revision

Beta Testing

MoodHaven Journal is in public beta. The core feature set is complete and stable. This page describes what to test, how to file useful issues, and known areas that need attention.

Desktop Testing

Setup Flow

  • First-run wizard: does it complete cleanly?
  • Password creation: does the strength indicator behave?
  • 2FA setup (TOTP): does the QR code scan correctly in an authenticator app? Do backup codes work?
  • Recovery key: is the 24-character code shown clearly? Does entering it on the lock screen unlock the app?
  • Factory reset: does "Erase & Start Fresh" work from the lock screen when you've forgotten the password?

Writing Entries

  • Auto-save: does it trigger after ~5 words?
  • Mood auto-detection: does the mood indicator update as you type? Does manual override lock it?
  • Templates: do all 7 templates insert correctly? Can you delete the prompt and write freely?
  • Focus mode: does the UI collapse cleanly? Does typewriter scroll work?
  • Books: create a book, write to it, filter the timeline to that book

Views

  • All Entries (timeline): search by text, filter by mood level, date range filter, clear filters
  • On This Day: does it show entries from past years correctly?
  • Insights: do mood stats, streak, and day-of-week patterns look correct for your data?
  • Calendar: mood heatmap for current month, click a day to see the daily timeline

Sync

  • Peer sync: if you have two machines on the same LAN, pair via QR code in Settings → Devices, write an entry on one, confirm it appears on the other
  • WebDAV: if you have Nextcloud/Synology/similar, configure backup in Settings → Sync and verify an encrypted .moodhaven file is uploaded

Edge Cases Worth Testing

  • Very long entries (10,000+ words)
  • Entries with unusual Unicode, emoji, and special characters
  • Rapid navigation between views while an auto-save is in flight
  • Lock → unlock cycle with 2FA enabled
  • Export, then import the exported file

Platform-Specific

  • Windows: installer (.msi), app icon in taskbar, window resize behaviour
  • macOS: DMG install, dock behaviour, system font rendering
  • Linux: AppImage works on your distro, .deb installs cleanly on Ubuntu/Debian

Wear OS Companion Testing (needs Wear OS 3+ hardware)

Core Recording

  • Record a voice memo on the watch — confirm it arrives in the desktop app
  • Confirm whisper.cpp transcribes it (may take a few seconds depending on model)
  • Use the "Create Entry" button — does the transcription pre-fill the editor?

Mood Taps

  • Tap a mood on the watch while MoodHaven Journal is not in the foreground on desktop
  • Confirm the mood signal lands in the app (check the Writing view — signals should appear)

Offline Queue

  • Take the phone out of Bluetooth range
  • Record a voice memo on the watch
  • Bring phone back into range
  • Confirm the memo transfers and appears in the desktop app

Health Context

  • If heart rate is available on your watch, confirm the health snapshot attaches to the voice memo

How to File a Good Issue

  1. Go to GitHub Issues
  2. Include:
    • OS and version (e.g. Ubuntu 22.04, Windows 11, macOS 14.4)
    • App version (shown in Settings → About)
    • Steps to reproduce (numbered, specific)
    • What you expected vs what happened
    • Screenshot or screen recording if visual
    • Log file if a crash (Settings → About → Open Log Folder)

Do not include journal content in issues. Sanitise any data before posting.

For security vulnerabilities: open a private advisory via GitHub (Security → Report a vulnerability) instead of a public issue.

Known Gaps

  • Media attachments are not yet synced over peer sync (planned)
  • Wear OS companion requires manual APK sideload (Play Store submission coming)
  • whisper.cpp transcription quality varies by model size — recommend ggml-base.en.bin as a starting point

Clone this wiki locally