Download Latest Version 1.7.0 - Web App _ Cloud Sync source code.tar.gz (5.6 kB)
Email in envelope

Get an email when there's a new version of Hero Planner

Home / 1.7.0
Name Modified Size InfoDownloads / Week
Parent folder
1.7.0 - Web App _ Cloud Sync source code.tar.gz 2025-12-11 5.6 kB
0
1.7.0 - Web App _ Cloud Sync source code.zip 2025-12-11 7.1 kB
0
README.md 2025-12-11 6.1 kB
0
Totals: 3 Items   18.9 kB 0

Hero Planner v1.7.0 Release Notes

Release Date: December 21, 2025

🎉 Major Features

1. ☁️ Cloud Synchronization

Full cloud sync support powered by Firebase Realtime Database: - Real-time data sync across all your devices - Sign in with Google for secure authentication - Automatic persistence - your schedules are never lost - Instant updates - changes sync automatically across devices

Cloud Sync Capabilities:

  • ✅ Schedule data (shifts, assignments, staff)
  • ✅ User preferences (theme, shortcuts, UI settings)
  • ✅ Superhero mode settings
  • ✅ Cross-device synchronization
  • ✅ Automatic backup to cloud

2. 🌐 New Web Client

Dedicated web application available at https://www.heroplanner.co.uk/: - No installation required - works in any modern browser - Full feature parity with desktop version - Real-time cloud sync with desktop app - Responsive design - works on desktop, tablet, mobile - Always up-to-date - automatic updates

Web-Only Features:

  • JSON file import from desktop app
  • Direct browser access (no download needed)
  • Mobile-friendly interface

3. 📥 JSON Import Feature

Import your desktop schedules to the web version: - Legacy format support - works with older exported files - Full data migration - transfers all schedule information - One-click import - simple file import dialog - No data loss - all staff, shifts, and assignments preserved

4. 📦 Desktop App (Electron)

Native Windows desktop application: - Independent operation - works offline - Cloud sync support - sync to web version via Firebase - Auto-updates - built-in update checker - System integration - runs as native Windows app

🐛 Bug Fixes

Cloud Sync Stability

  • Fixed state persistence for theme preferences
  • Fixed superhero mode settings not persisting
  • Fixed keyboard shortcuts not saving across sessions
  • Resolved Firebase initialization timing issues

UI Improvements

  • Archived staff filtering - archived staff no longer appear in:
  • Absence planner dropdown
  • Team coverage overview
  • Staff assignment dropdowns
  • Proper staff status management

Data Import

  • Fixed legacy file format support
  • Removed strict dataVersion validation
  • Support for files without version metadata

🔒 Security Improvements

API Key Protection

  • Environment variables - Firebase API keys moved to environment variables
  • No hardcoded secrets - keys not stored in git repository
  • Secure by default - production environment variables isolated

Best Practices Implemented

  • Server-side authentication via Firebase
  • User-scoped database rules
  • Encrypted environment variable handling
  • Regular security audits

🚀 Deployment

Web Version

Desktop Version

  • Platform: Electron
  • Format: Windows executable (portable)
  • File: Hero Planner 1.7.0.exe
  • Size: ~100 MB
  • Status: Production ready

📋 System Requirements

Web Version

  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • JavaScript enabled
  • Internet connection for cloud sync

Desktop Version

  • Windows 10 or later
  • 100 MB disk space
  • Internet connection for cloud sync

🔄 Migration Guide

From Desktop to Web

  1. Open web version at https://www.heroplanner.co.uk/
  2. Sign in with Google
  3. Start using cloud sync immediately
  4. Optional: Import desktop schedules via JSON

Syncing Desktop & Web

  1. Use same Google account on both
  2. Enable cloud sync in both versions
  3. Changes sync automatically
  4. Works offline - syncs when back online

📊 What's Changed

Version 1.6.1 → 1.7.0

Feature v1.6.1 v1.7.0
Cloud Sync ❌ ✅
Web Version ❌ ✅
JSON Import ❌ ✅
Desktop App ✅ ✅ Enhanced
Security Standard 🔒 Enhanced
Platform Desktop only Desktop + Web

🎯 Known Limitations

  • Desktop version uses web-based cloud sync (no local-only option)
  • Internet connection required for cloud features
  • Google account required for authentication
  • Firebase project must be configured by self-hosting users

🔗 Quick Links

🛠️ Developer Information

Technology Stack

  • Frontend: React 18, Vite 7.2
  • Desktop: Electron 39
  • Backend: Firebase Realtime Database
  • Authentication: Google OAuth
  • Styling: Tailwind CSS
  • Build: Vite + Electron Builder

Environment Configuration

Development and production environments require:

VITE_FIREBASE_API_KEY
VITE_FIREBASE_AUTH_DOMAIN
VITE_FIREBASE_DATABASE_URL
VITE_FIREBASE_PROJECT_ID
VITE_FIREBASE_STORAGE_BUCKET
VITE_FIREBASE_MESSAGING_SENDER_ID
VITE_FIREBASE_APP_ID
VITE_FIREBASE_MEASUREMENT_ID

See SETUP_GUIDE WIKI for detailed configuration instructions.

📝 Version History

  • v1.7.0 (Dec 21, 2025) - Cloud sync, web client, JSON import
  • v1.6.1 - Desktop app stability
  • v1.6.0 - Finance feature roadmap
  • Earlier - Desktop scheduling foundation

🙏 Credits

  • Built with React, Vite, and Electron
  • Cloud infrastructure powered by Firebase
  • Icons from Heroicons
  • UI framework Tailwind CSS

Questions or issues? Please refer to the SETUP_GUIDE.md or contact support.

Ready to get started? Visit https://www.heroplanner.co.uk/ or install the desktop version!

Download Hero Planner

Source: README.md, updated 2025-12-11