RehearsalHQ v1.2.1

RehearsalHQ v1.2.1 is a maintenance release that expands Docker image distribution by adding Docker Hub publishing alongside the existing GitHub Container Registry (GHCR).

This update provides an additional option for downloading and deploying RehearsalHQ Docker images.

What's New

Docker Hub Support

RehearsalHQ Docker images are now published to Docker Hub in addition to GHCR.

• Dual Registry Publishing: Release images are published to both Docker Hub and GitHub Container Registry.
• Consistent Versioning: Both registries use the same release version tags.
• Automated Publishing: GitHub Actions handles publishing to both registries when a new version tag is pushed.
• CI Integration: Existing automated checks must pass before images are published.
• More Deployment Options: Users can choose their preferred container registry when deploying RehearsalHQ.

Improvements

• Updated the GitHub Actions publishing workflow to support Docker Hub authentication.
• Added support for Docker Hub repository credentials through GitHub Actions secrets.
• Extended Docker image metadata and tagging to include both registries.
• Preserved the existing GHCR publishing workflow.

Deployment Notes

No application configuration changes are required for existing installations.

• Existing GHCR-based deployments can continue using their current image references.
• Docker Hub is now available as an alternative image source.
• Application functionality, database schemas, and media storage remain unchanged.

---

What's Changed

• Feat: publish to docker hub by @dcoffin88 in #8

Full Changelog: v1.2.0...v1.2.1

RehearsalHQ v1.2.0

RehearsalHQ v1.2.0 introduces Multi-Band Support, allowing multiple bands to operate independently within a single application instance.

This release also introduces Super Admin management, a redesigned permission hierarchy, secure account invitations, self-service password recovery, and centralized security and email settings.

With isolated band workspaces and improved account administration, RehearsalHQ is now better equipped to support multiple bands while keeping their music, members, schedules, and settings separate.

What's New

Multi-Band Support

RehearsalHQ now supports multiple independent bands within a single installation.

• Independent Band Workspaces: Each band maintains its own songs, recordings, rehearsals, settings, notifications, and memberships.
• Band Switching: Members belonging to multiple bands can switch directly from the account menu.
• Band-Specific Permissions: Users can have different roles in different bands.
• Isolated Media Storage: Audio files are organized into separate band directories.
• Persistent Sessions: The application remembers your active band between sessions.
• Audio Player Integration: Switching bands automatically resets the global audio player to prevent playback across workspaces.
• Automatic Migration: Existing installations are automatically migrated into their original band, preserving existing content and media files.

Super Admin Management

Introducing the new Super Admin role for application-wide administration.

Super Admins can:

• Create and manage band instances.
• Grant or remove Super Admin privileges.
• Manage users across all bands.
• Configure global authentication and security policies.
• Manage application-wide SMTP and email settings.
• Perform all standard Band Admin operations.

Additional safeguards:

• Promoting a user to Super Admin requires explicit confirmation.
• Super Admins automatically receive Band Admin access to every existing and future band.
• Removing Super Admin privileges preserves existing band memberships.
• Band Admins cannot modify protected Super Admin accounts.

Improved Roles & Permissions

RehearsalHQ now uses four clearly defined roles:

• Super Admin: Full application-wide administration.
• Band Admin: Manages an individual band's members, recordings, rehearsals, and settings.
• Band Member: Standard band participation and content management.
• Band Guest: Limited access based on existing guest permissions.

Additional improvements include:

• Updated Role Permissions Breakdown.
• Clearer role labels throughout the application.
• Improved account protection and administrator hierarchy.
• Server-side enforcement of role restrictions.
• Safeguards against removing the last active administrator.

Improved Member Invitations

Adding members to a band is now easier and more secure.

New Users

• Administrators can invite new members directly from User Management.
• When email is enabled, members receive a secure invitation link.
• Invited members choose their own password during account setup.
• Invitation links expire after 7 days.
• Resending an invitation invalidates the previous link.
• Accounts remain marked as Invited until setup is complete.

Existing Users

• Add existing RehearsalHQ users to additional bands without creating duplicate accounts.
• Existing credentials and profile information are preserved.
• Assign a different role for each band.
• Invitation emails explain how to access the additional band.

When SMTP is disabled, administrators can continue creating accounts with an initial password.

Password Recovery & Account Security

Introduced secure, self-service password recovery.

• Forgot Password: Members can request password resets directly from the login screen when SMTP is enabled.
• Secure Reset Links: One-time password reset links expire after 30 minutes.
• Session Protection: Successful password resets revoke existing sessions and remembered devices.
• Account Privacy: Password recovery does not reveal whether an email address is registered.
• Secure Tokens: Setup and reset tokens are stored as hashes and excluded from email logs.

Administrator Password Resets

• With SMTP enabled, administrators can send secure password reset links.
• With SMTP disabled, administrators can assign temporary passwords.
• Invited users continue through the invitation workflow until their account is activated.

Centralized Authentication Management

Authentication and security policies are now managed globally by Super Admins.

• Application-wide session timeout settings.
• Consistent password requirements across every band.
• Global login lockout policies.
• Centralized two-factor authentication enforcement.
• Protected access to authentication management settings.

Existing authentication configurations migrate automatically and remain consistent when switching bands.

Centralized Email Settings

SMTP configuration is now shared across the entire RehearsalHQ installation.

• One global email configuration serves all bands.
• Only Super Admins can access SMTP settings and email administration.
• Email testing, notification resending, and email log management are restricted to Super Admins.
• Existing SMTP configurations migrate automatically.
• Band Admins cannot access SMTP credentials or application-wide email logs.

Band-specific notifications continue to operate independently within their respective workspaces.

User Management Improvements

User Management now provides clearer workflows and more granular administrative control.

• Separate options for adding new users and existing accounts.
• Updated role selectors and permission descriptions.
• Protected account indicators for restricted users.
• Improved invitation status and delivery feedback.
• Resend Invite disappears after a member's first successful login.
• Band Admins can manage Members and Guests, including role changes, password resets, 2FA resets, and removal from their band.
• Super Admins retain application-wide account management capabilities.

Fixes & Improvements

• Migrated existing installations and media files to the new multi-band structure.
• Improved band-specific database access and authorization.
• Added stronger protection against unauthorized cross-band access.
• Updated account management safeguards and administrator permissions.
• Improved invitation and password reset token security.
• Added automatic session and trusted-device revocation after password resets.
• Standardized role names across navigation, profiles, emails, and documentation.
• Updated database migrations through schema version 10.
• Updated the README with multi-band configuration, administration, invitations, and password recovery instructions.

---

Important Upgrade Notes

Existing installations are automatically migrated to the new multi-band architecture.

• Your existing band, users, songs, rehearsals, and media files are preserved during migration.
• The first active Admin is automatically promoted to Super Admin.
• Existing media files are reorganized into band-specific directories.
• Existing SMTP and authentication settings are migrated to global configuration.
• Database schema migrations are applied automatically.

Recommendation: Back up your database and media directory before upgrading, particularly because this release changes database structures and media storage paths.

---

What's Changed

• Feat: add multi-band support, Super Admin role, and account management workflows by @dcoffin88 in #7

Full Changelog: v1.1.0...v1.2.0

RehearsalHQ v1.1.0

RehearsalHQ v1.1.0

RehearsalHQ v1.1.0 is a major feature release introducing Tabs Studio, a dedicated Chords Studio, enhanced Lyrics Studio, complete two-factor authentication, advanced demo archiving, and improved rehearsal scheduling.

This update also introduces personalized notification settings, downloadable song archives, comprehensive mobile improvements, and numerous usability enhancements throughout the application.

What's New

New Tabs Studio

A fully integrated tablature editor for creating and managing guitar and bass tabs.

• Dedicated Tabs Studio with database persistence.
• Support for 19 guitar and bass tunings, including Standard, Drop D, and alternate tunings.
• Fixed-width editor that preserves tablature spacing.
• Automatic staff generation with the selected tuning.
• Insert Intro, Verse, Chorus, Bridge, and Outro sections.
• Automatic notation legends supporting bends, slides, hammer-ons, pull-offs, palm muting, vibrato, and more.
• Import existing .txt tablature files.
• Copy, download, print, or save tabs as PDF.
• Edit tabs while listening to the associated audio demo.
• Track revisions, last editor, and unsaved changes.
• Guest read-only access with Member and Admin editing permissions.

Dedicated Chords Studio

Chord charts now have their own studio, separate from Lyrics Studio.

• Visually place chords above selected lyrics.
• Interactive Chord Selection Chart with 12 roots and 11 chord qualities.
• Support for slash chords, bass notes, and N.C..
• Click existing chords to replace them.
• Toggle between visual chord selection and direct text editing.
• Automatically populate new chord charts from saved lyrics.
• Preserve compatibility with existing chord charts.
• Dedicated chord update notifications.

Improved Lyrics, Chords & Tabs Editors

All three studios now support:

• Full-screen editing with Escape-key support.
• Print / Save as PDF with Letter-size layouts and automatic font scaling.
• Improved song selection and navigation.
• Direct access from song cards and the global audio player.

Lyrics Studio also features automatic section numbering, including [Verse 1], [Verse 2], [Chorus 1], and more.

Demo Archiving & ZIP Downloads

Introducing a comprehensive demo archiving and retention system.

• Download ZIP for every demo, including all original audio versions, lyrics, chords, and tabs.
• Archive demos without immediately deleting their content.
• Archived demos remain accessible in read-only mode.
• Restore archived demos to their previous category.
• Admin-only permanent deletion with confirmation.
• Automatic permanent deletion after 30 days, enabled by default and configurable in Admin Settings.
• Archived demos are excluded from active song lists, studios, and rehearsal setlists.
• Email notifications inform members when demos are archived and scheduled for deletion.
• Archived events can be viewed and filtered in the Email Outbox.

Custom Demo Categories

Administrators can now manage demo categories directly from Admin Settings.

• Add and rename categories.
• Remove unused categories.
• View how many demos belong to each category.
• Preserve category associations when renaming.
• Protect the system's Archived category from deletion.

Complete Two-Factor Authentication (2FA)

RehearsalHQ now includes fully implemented TOTP-based two-factor authentication.

• Administrators enable 2FA from Authentication Management.
• Members enroll at their next sign-in using a QR code or manual setup key.
• Compatible with standard TOTP authenticator apps.
• Eight single-use recovery codes are generated during enrollment.
• TOTP secrets are encrypted in the database.
• Authentication sessions are only created after successful verification.
• Failed verification attempts are limited.
• Administrators can reset member 2FA enrollment and revoke sessions.

Remember This Device

• Option to trust a device for 30 days.
• Trusted devices can skip the 2FA verification code during that period.
• Password authentication is still required for every new login.
• Trusted devices are automatically revoked following relevant account security changes.

2FA is disabled by default and can be enabled by an administrator.

Personalized Notification Preferences

Every user can now independently manage their email notifications from Profile & Settings.

Notification options include:

• New audio demos and takes.
• Lyrics and chord-chart changes.
• Rehearsal scheduling and updates.
• RSVP and timed rehearsal reminders.
• Band feedback and comments.
• Archived-demo notifications.

Existing accounts automatically receive the new preferences enabled, and administrators retain control of the global SMTP configuration.

Improved Rehearsal Scheduling

Rehearsal scheduling now includes stronger validation and automatic retention.

• Prevent scheduling rehearsals on past dates.
• Clearly distinguish upcoming sessions from past events.
• Past sessions are locked against editing and RSVP changes.
• Automatically remove past rehearsals 30 days after their scheduled end time.
• Manual deletion remains available.
• Archived demos are excluded from rehearsal song selection.
• Added a Past Events divider for easier navigation.

Global Audio Player Improvements

Added a Song Docs menu to the global audio player.

• Lyrics: Opens Lyrics Studio for the playing demo.
• Chords: Opens Chords Studio for the playing demo.
• Tabs: Opens Tabs Studio for the playing demo.

Quickly switch between listening and editing without manually searching for the song.

Mobile & Interface Improvements

• Responsive navigation dropdowns replace horizontal scrolling on smaller screens.
• Compact category filters and administrator navigation.
• Improved mobile upload controls.
• Streamlined studio toolbars.
• Mobile-optimized Chords Studio with direct editing.
• User-specific Chord Selector preference that restores automatically on desktop.
• Improved light-mode contrast across studios, RSVP controls, category filters, and archive actions.
• Refined layout and navigation consistency throughout the application.

Fixes & Improvements

• Corrected tuning display order across editors, downloads, and printed tabs.
• Improved tablature section insertion and notation detection.
• Ensured generated legends stay synchronized and positioned at the bottom.
• Prevented archived demos from remaining selected in studios.
• Added server-side enforcement of archived demo restrictions.
• Improved chord alignment, replacement, and editing workflows.
• Removed the legacy Lyrics modal in favour of direct studio navigation.
• Improved handling of past rehearsals and expired scheduled events.
• Consolidated notification preferences into individual user settings.
• Updated database migrations, automated tests, and deployment documentation.

---

What's Changed

• feat: add Tabs Studio, enhance song editors, improve archiving, and introduce 2FA backend by @dcoffin88 in #6

Full Changelog: v1.0.4...v1.1.0

RehearsalHQ v1.0.4

This release introduces new event scheduling features, improved audio management, enhanced notifications, simplified permissions, and a more polished user experience throughout RehearsalHQ.

What's New

Events & Scheduling

• Added event reminders to help members stay informed about upcoming activities.
• Added the ability to add events to your calendar.
• Introduced inline editing for upcoming events.
• Added a 12/24-hour time format switcher.

Audio & Lyrics

• Added support for editing audio file metadata.
• Added a close button to the global audio player.
• Improved waveform animations to respect user preferences.
• Refined the Lyrics Studio experience.

Notifications

• Updated notification email templates for improved presentation.
• Enhanced notification handling and supporting backend functionality.

Members & Permissions

• Simplified permissions by merging the Editor role into the Member role.
• Improved nickname support throughout the application.
• Restricted the application version badge to administrators.
• Moved the accentGlow setting into administrator settings.

Interface Improvements

• Improved consistency across application settings and navigation.
• Refined various UI components for a smoother experience.
• Added a legal notice to the login screen.

Deployment & Documentation

• Updated and reorganized the README.
• Improved Docker deployment instructions.
• Clarified environment configuration and installation options.

Fixes & Improvements

• Refined audio player controls and animation behaviour.
• Improved event management workflows.
• Enhanced administrator settings and permission handling.
• Updated supporting backend functionality and server tests.
• General usability improvements and interface refinements.

---

Full Changelog: v1.0.3...v1.0.4

RehearsalHQ v1.0.3

What's Changed

RehearsalHQ

BandApp has been renamed to RehearsalHQ, with updated branding throughout the application, documentation, deployment configuration, and GitHub automation.

• Added the new RehearsalHQ icon and favicon.
• Updated repository artwork and screenshots.
• Updated page titles, application labels, email content, and documentation.
• Renamed the container image to ghcr.io/dcoffin88/rehearsalhq.

Version and Update Tracking

• Added the current version to the navigation bar.
• Added automatic checks for new GitHub releases.
• Added a release details modal with release notes and update links.
• Added caching and offline fallback for version checks.
• Synchronized frontend, backend, package, and lockfile versions during releases.
• Added CI validation to prevent publishing mismatched versions.

Backend Improvements

• Refactored the server into separate application, database, and media modules.
• Improved request handling and TypeScript coverage.
• Improved database and uploaded-media handling.
• Updated server tests for the new application interface.

Release Automation

• Added interactive confirmation before pushing the release commit and tag.
• Added interactive creation of a draft GitHub Release.
• Added GitHub CLI installation and authentication checks.
• Added --no-publish for local release validation.
• Expanded release tests to cover every version source.

Cleanup

• Removed the unused Band Roles view.
• Removed the obsolete client-side notification service.
• Removed unused exports, metadata, and branding assets.
• Removed the redundant Bun lockfile and standardized the project on npm.

Upgrade Notes

Important

Back up your database and uploaded media before upgrading an existing installation.

The following deployment identifiers changed:

• Database: bandapp.sqlite → rehearsalhq.sqlite
• Container image: ghcr.io/dcoffin88/bandapp → ghcr.io/dcoffin88/rehearsalhq
• Compose project: bandapp → rehearsalhq
• Data volume: bandapp_data → rehearsalhq_data
• Media volume: bandapp_media → rehearsalhq_media

For bind-mounted deployments, stop the application and rename the existing database file before starting the new image:

mv ./data/bandapp.sqlite ./data/rehearsalhq.sqlite


* Feat: Rebranded as RehearsalHQ by @dcoffin88 in https://github.com/dcoffin88/RehearsalHQ/pull/4


**Full Changelog**: https://github.com/dcoffin88/RehearsalHQ/compare/v1.0.2...v1.0.3

BandApp v1.0.2

What's Changed

1. Resolved Missing Server Module Error:

• Reconstructed and properly typed the backend modules referenced by server.ts:
  • /server/app.ts: Express application bootstrap, API routing, authentication, session tokens, audit logging, audio streaming with HTTP Range requests, and email dispatch endpoints (/api/smtp/verify, /api/smtp/test, /api/smtp/resend).
  • /server/database.ts: SQLite persistence (DatabaseSync) for members, songs, rehearsals, audit logs, and email history.
  • /server/media.ts: Secure filesystem audio vault with path sanitation and streaming support.
• Fixed SQLite argument parameter types and ensured both npm run build and tsx watch server.ts compile without errors.

2. Version Tracking Engine (src/utils/versionService.ts & /api/version/check):

   • Compares the running application version against the latest release published at https://github.com/dcoffin88/BandApp/releases/latest.
   • Uses strict semver parsing to determine when a newer version is published.
   • Dual-layer fetch strategy:
     • Primary: Backend proxy endpoint /api/version/check with in-memory caching to prevent GitHub API rate limits.
     • Secondary: Direct client-side fetch to https://api.github.com/repos/dcoffin88/BandApp/releases/latest with CORS support as a fallback.

3. Interactive Version Badge (src/components/VersionBadge.tsx):

   • When Up-to-Date:
     • Displays a badge: ✓ v0.0.0.
   • When an Update is Available:
     • Highlights with: v1.0.1 • Update Available.

4. Release Details & Update Modal (src/components/VersionModal.tsx):

   • Clicking the badge opens a release details modal with:
     • Side-by-side comparison of Installed Version vs Latest on GitHub.
     • Status notification and changelog/release notes preview.
     • Direct button to "View Latest Release on GitHub" (https://github.com/dcoffin88/BandApp/releases/latest).
     • Link to the dcoffin88/BandApp GitHub repository.
     • A "Check now" button with a live refresh indicator and last-checked timestamp.

---

• Feat: Add Version Tracking, Update Notifications & Backend Stability Improvements by @dcoffin88 in #3

Full Changelog: v1.0.1...v1.0.2

BandApp v1.0.1

What's Changed

• Fix: improved code readability by @dcoffin88 in #2

Full Changelog: v1.0.0...v1.0.1

BandApp v1.0.0

What's Changed

• Prepare BandApp for first release by @dcoffin88 in #1

New Contributors

• @dcoffin88 made their first contribution in #1

Full Changelog: https://github.com/dcoffin88/BandApp/commits/v1.0.0