Dashboard
The HandyCafe Server dashboard is the central hub for managing your internet cafe or gaming center. It is the main window that holds every other page in the system. All navigation, monitoring, and management tasks begin here.
After signing in, you land on the first sidebar page your role can open. For most staff this is Monitoring, a board of widgets that shows computers, consoles, Wi-Fi, bills and takings on one screen. See Monitoring Board.
Layout Overview
The dashboard is divided into four areas:
- Top Panel. A horizontal header bar across the top of the window. It displays the title of the currently active page and holds the menu, search, screenshot and theme buttons. See Top Panel Buttons.
- Sidebar Toolbar. A vertical navigation bar on the left side. Each item is an icon button that switches to a different page. The active page is visually highlighted.
- Content Area. The main workspace to the right of the sidebar. This area renders the currently selected page (Monitoring, Computers, Members, Reports, and so on).
- Status Bar. An optional footer bar at the bottom of the window. You can show or hide it from the View settings.
Top Panel Buttons
Global Search
Click the magnifier in the top panel or press Ctrl+F or Ctrl+K (Cmd+F or Cmd+K on macOS), to open Search pages and settings.... Type part of a name to find pages, tabs inside pages and individual settings. Use the arrow keys and Enter to open a result and Escape to close the search. A settings result opens Settings on the right page and section.
Results only include pages and settings the signed-in cashier can open. Pages hidden in Settings > View are left out too. Hide the button itself with Search button in Settings > View > Visibility under Application frame.
Screenshot
The camera button captures the server screen: the HandyCafe window, the full screen, a region or a single window. See Capturing the Server Screen.
Reconnect Client Requests
For administrators, a network button with a red count appears when a client PC cannot reach this server and asks to be reconnected, or when an unconnected computer is found on the network. A new reconnect request also opens the Reconnect client dialog on its own. There you choose Connect client, Reject, or Reject & block. Without pending requests, the button opens the Connection Wizard. See Client Settings for how a client asks for reconnection.
Sidebar Navigation
The sidebar toolbar provides quick access to every page in the system. Each entry shows an icon. Hover over an icon to see the page name, or turn on Expanded Sidebar in Settings > General to show the names next to the icons.
The main list is split into groups by thin divider lines:
| Page | Description |
|---|---|
| Monitoring | Board of widgets for the whole cafe. See Monitoring Board. |
| Computers | Monitor and manage all client PCs. See Admin Panel. |
| Consoles | Manage gaming console sessions. See Consoles. |
| Wi-Fi | Sell and manage guest Wi-Fi access. See Wi-Fi Vouchers. |
| Bills | Open and closed customer bills. See Bills. |
| Members | Create and manage member accounts. See Members. |
| Vouchers | Prepaid access vouchers for walk-in customers. See Vouchers. |
| Orders | Food, drink and product orders. See Orders. |
| Reservations | Seat and console reservations. See Reservations. |
| Stock | Cafe menu, stock levels, stock receipts and suppliers. See Stock. |
| Campaigns | Campaigns and packages. See Campaigns. |
| Subscriptions | Member subscriptions that run out or are owed. See Subscriptions. |
| Cash | Money in and money out of the till. See Expenses. |
| Reports | Cash register and transaction reports. See Cash Report. |
| Analytics | Revenue, session, member and tax analytics. See Analytics. |
| Logs | System, transaction and audit logs. See Logs. |
Two blocks sit at the bottom of the sidebar:
| Page | Description |
|---|---|
| Cafeteria | Cafeteria tables and orders. Shown only when the cafeteria module is turned on. See Cafeteria. |
| Games | Game catalog. See Games Catalog. |
| Summary | Day-end summary of sales, expenses and cash. See Day-End Summary. |
| Cloud | HandyCafe Cloud modules. See Cloud. |
| AI | AI assistant. See AI Assistant. |
| Internet | Internet lines and gateway traffic. See Gateway. |
| Settings | Configure all system settings. See Settings. |
Software licenses are no longer a sidebar page. They are managed under Settings > Licenses.
To hide entries your cafe does not use, open Settings > View, select the Visibility tab and turn entries off in the Side bar list. The Applies to selector limits the change to one role. See View Settings.
Badges
The Orders entry displays a badge with the count of open orders. The Reservations entry displays a badge with the count of pending reservations. Both counts update in real time so cashiers can immediately see if there is outstanding work.
Role-Based Page Access
Not every user sees the same sidebar. Page visibility depends on the logged-in cashier's role and permissions:
- Admin accounts (created during the First Setup Wizard) have unrestricted access to all pages.
- Cashier accounts are assigned a role with specific permission flags. If a cashier's role does not grant access to a particular page, that page is hidden from their sidebar.
- An entry hidden in Settings > View is hidden in addition to the role permissions.
- After sign-in, the cashier opens on the first sidebar page they can access. If the current page becomes restricted, the system moves them to the first accessible page.
For more information about roles and permissions, see Cashier Roles and Permissions.
Auto-Update Checking
On startup, and then every five minutes, the server asks the HandyCafe update catalog whether a newer release exists for its channel. A stable build follows the stable channel and a beta build follows the beta channel.
When a newer HandyCafe Server version is available, the HandyCafe Server update available dialog opens with the new version number. Choose Update now to download and install it. HandyCafe Server then restarts on the new version. Choose Remind me later to close the dialog. It does not open again until the server is restarted. View changes opens the release notes.
Nothing is downloaded or installed until you choose Update now. If no update is available or the catalog cannot be reached, no dialog is shown. Once the server is on the latest version, newer client versions are offered to the client PCs. See Client Updates.
License Heartbeat
After the dashboard loads, a license heartbeat process starts in the background. This process periodically validates your HandyCafe license with the licensing server. If the license expires or encounters an issue, a Beta License Overlay may appear over the dashboard, restricting the application to read-only mode until the license is resolved.
See Licensing for details on license management.
Status Bar
The status bar is a thin horizontal bar at the bottom of the dashboard. It shows, from left to right:
- The product name and the installed version.
- The cloud settings sync badge. It tells you whether the latest settings save reached the cloud. See Cloud Settings Sync.
- The share of computers in use, as a percentage.
- The current download and upload speed.
- The zoom level. Click it to open a slider that scales the whole interface. The zoom is saved for the signed-in cashier.
To show or hide the status bar: Open Settings > View, select the Visibility tab and toggle Status bar under Application frame.
When hidden, the content area expands to fill the full height of the window.
Bootstrap Sequence
When the dashboard loads after a successful login, several initialization steps happen automatically:
- Listeners for client events and for legacy V3 and V4 clients start.
- System settings are loaded from the database.
- Saved sessions are restored (if any were running before a restart).
- The server socket starts listening for client connections. A socket that is already running is kept.
- A network ping request is sent to discover connected clients.
- The cashier's role permissions are loaded and restricted pages are hidden.
- The license status is checked.
- The license heartbeat starts.
- The open order and pending reservation counts are loaded for the sidebar badges. The open bill count, pending guest login requests and reconnect requests are loaded too.
- Live notifications start for new and cancelled reservations, USB devices plugged into or removed from client PCs, scheduled health check alerts, the cloud connection and the Internet gateway.
- An update check runs in the background.
None of these steps blocks the dashboard. If one fails, the failure is logged and the dashboard keeps working.
System Font
The dashboard respects the system font setting configured in Settings > General. All text throughout the interface uses the selected font family.
Next Steps
- Monitoring Board: Arrange the widget board you land on
- Admin Panel: Learn how to monitor and control client PCs
- Session Management: Start, pause, and stop sessions
- Settings: Configure system preferences
- Cashier Login: Understand the login process