Modern shift handover solution for shift-based teams
Document, manage, and communicate critical shift information with searchable, color-coded logs and real-time info slides. Perfect for hotel operations, security teams, reception desks, and any organization working in shifts.
Shift Handover Log is a comprehensive web application designed to streamline communication between shifts. With an intuitive interface, powerful search capabilities, and real-time information displays, it ensures that critical information is never lost in transition.
- 🏨 Hotel Operations - Front desk, housekeeping, maintenance teams
- 🛡️ Security Teams - Incident reporting and shift transitions
- 🏢 Reception Desks - Customer service and administrative teams
- 🏭 Manufacturing - Production line handovers
- 🚑 Healthcare - Patient care transitions
- Any team working in shifts
Alpha v0.26.03-Alpha.4 - This project is in alpha testing phase.
⚠️ Use at your own risk⚠️ Features may be incomplete or unstable⚠️ Regular backups recommended⚠️ Default admin password must be changed immediately
- Create & Edit - Easily create new log entries with rich text formatting
- Search & Filter - Find logs by date, worker, or keywords instantly
- Color Coding - Visual priority system (green, yellow, blue, red)
- Archive System - Keep your active logs clean while preserving history
- Expanded View - Detailed log view with smooth navigation
- Print Support - Export visible logs with custom formatting
- Pagination - Navigate through large log collections effortlessly
- Real-time Clock - Always know the current time
- Permanent Info Slide - Access critical information with one click
- @Mentions - Highlight team members in notes (excludes email addresses)
- Rich Text Editor - Full formatting support (bold, italic, underline, strikethrough, colors, emojis)
- WYSIWYG Editing - What you see is what you get
- Compact Table View - Efficient overview with expandable details
- Secure Authentication - Password-protected admin access with configurable session expiry
- User Management - Add, edit, delete, and reorder users with email support
- Role-Based Access - Assign users as Admin or Normal User
- Password Email - Send credentials via email (SMTP configuration required)
- Customizable Page Title - Brand your application
- Permanent Information Editor - Manage info slides with rich text
- Password Management - Secure password change on first login
- Login Expiry Settings - Configure session duration (1-168 hours) with enable/disable toggle
- Real-time Updates - Changes take effect immediately
- Admin Protection - Admin user cannot be deleted or renamed
- Responsive Design - Works seamlessly on desktop, tablet, and mobile
- Intuitive Interface - Clean, modern design that requires no training
- Fast Performance - Instant search and filtering
- Visual Feedback - Flash animations for updated entries
- Keyboard Navigation - Power user shortcuts
The easiest way to get started! No installation required - just run the executable.
- Download the
distfolder (pre-compiled distribution) - Double-click
HandoverServer.exe - Click "Start Server"
- Open http://localhost:8500 in your browser
👉 See detailed guide: INSTALL_GUIDE_DIST.md
- Node.js 14+ required. If not installed:
- Option A: Install from nodejs.org
- Option B: Run
.\setup-portable-nodejs.ps1to download portable Node.js todist/nodejs
- Run
.\install.batto install dependencies (use.\prefix in PowerShell) - Run
.\setup-db.batto initialize the database - Run
.\start.batto launch the application - Access http://localhost:3000 in your browser (dev mode)
👉 Complete Documentation: See docs/USER_MANUAL.md for comprehensive feature documentation.
| Action | How To |
|---|---|
| Create Log | Click "Create New Log" button |
| Edit Log | Click "Edit" on any log entry, or use the 🔍 magnifying glass icon |
| Archive | Click "Archive" to archive, "Restore" to restore |
| Search | Use the search box and filters at the top |
| Info Slide | Click the (i) button on the left side |
| Expanded View | Click the 🔍 icon next to any short description |
| Click "Print Visible Logs" - title shows "Page Name YYYY.MM.DD" | |
| Navigate Logs | Use keyboard arrows or side buttons in expanded view |
- Click the "⚙️ Admin" link in the header
- Login with default credentials:
- Username:
admin - Password:
pass123
- Username:
⚠️ IMPORTANT: Change the password immediately on first login
- Page Name - Customize the application title displayed in the header
- Permanent Information - Edit information shown in the info slide (accessible via the (i) button)
- Login Expiry - Enable/disable login session expiry and configure duration (1-168 hours)
All changes take effect immediately after saving.
| Issue | Solution |
|---|---|
| Application won't start | Verify Node.js is installed (Local) or use Standalone executable |
| Backend errors | Check that port 8500 is available and backend server is running |
| Database errors | Verify data/shift_logs.db exists and is accessible |
| Frontend not loading | Ensure port 8500 is free and server is running |
| Search not working | Check browser console for JavaScript errors |
- Check the browser console (F12) for error messages
- Verify server is running (port 8500)
- Restart the server
- Review docs/TROUBLESHOOTING.md for detailed solutions
- User Manual - Complete feature documentation
- Quick Start Guide - Fast installation guide
- Standalone Installation - Complete guide for dist folder
- Network Access - Configure network access
- Troubleshooting - Common issues and solutions
This project is licensed under the MIT License - see the LICENSE file for details.
Miguel da Silva
Built with modern web technologies to provide a seamless shift handover experience for teams worldwide.
⭐ If you find this project useful, consider giving it a star!