LocalSync Restaurant OS
High-Performance Local Network Restaurant Management
<50ms
WebSocket Sync
0
Cloud Dependency
100%
Uptime on LAN
Executive Overview
Engineered for operational resilience and business intelligence, this Full-Stack Restaurant POS system reimagines dining management. Built with a monolithic local-first architecture (React, Express, custom JSON store), it ensures 100% uptime regardless of internet stability.
The Problem
Cloud POS systems fail during internet outages, and legacy local systems lack real-time multi-device sync.
The Solution
An offline-first, browser-based local ecosystem utilizing WebSockets for instant, reliable communication across all restaurant devices.
Core Capabilities
Real-Time KDS
Instant kitchen tickets with prep timers and priorities.
Offline-First Architecture
Full operations continue seamlessly without internet.
Browser-Based Access
Access via local IP (no heavy app installs required).
Hybrid Staff Roles
Dynamic permissions for owners, waiters, and cashiers.
System Architecture
Architecture Flow
How data moves through the system, from user interaction to backend processing and response generation.
Startup
Run npm start → Node.js Express server starts on port 7070 → Serves the compiled React app (dist/) to any browser on the WiFi network.
Interface Gallery
Owner Dashboard
Interface Gallery
Centralized command center for the restaurant owner. Sales monitoring, staff management, menu control, inventory tracking, table operations, and AI-powered analytics — all from one dashboard.
Command Panel
Technical Deep Dive
Module Breakdown
Waiter POS Module (Touch-optimized mobile UI), Kitchen Display System (Large-screen grid, auto-refreshes), Admin Dashboard (Aggregates revenue), AI Combo Engine (Gemini integration).
Local Network Magic
The backend scans the computer's network interfaces to auto-detect its local IP (192.168.x.x) and displays it on the admin dashboard. The entire restaurant operates through that one host PC — no internet needed.
Database Structure
All data lives in local-data/restaurant-data.json. Keys: auth.users, profile, menuItems, orders, inventory, cleaningTasks.