The Operational Heart of Wellness. A cutting-edge, mission-critical management platform designed for the fast-paced environment of a premium spa. SpaCashier empowers staff with real-time tools to manage sessions, finances, and human resources with unrivaled efficiency.
SpaCashier is the definitive interface between business strategy and daily excellence. It simplifies complex operational workflows into an intuitive, high-performance dashboard that ensures every customer interaction is handled with precision.
- Real-time Sales: Sub-second transaction processing with automated tax and discount logic.
- Smart Printing: Integrated support for thermal receipt printing, barcodes, and professional PDF invoices.
- Cashflow Visibility: Live tracking of drawer status, wallet balances, and inter-account transfers.
- Dynamic Floor Plan: Real-time room and bed occupancy tracking with therapist assignment visualization.
- Active Session Management: Granular control over the spa lifecycle—from booking check-in to session completion.
- Global Inventory & Master Data: Centralized management of treatments, categories, and branch-specific assets.
- Biometric Edge: Native sync with ZKTeco devices ensures 100% accuracy in staff attendance records.
- Performance Insights: Dedicated HRD modules to track therapist productivity, commissions, and shifts.
- Push Engagement: Native browser-level push notifications for shift alerts and critical system updates.
- Journal Integrity: Direct visibility into double-entry accounting records generated by the backend engine.
- Automated Reporting: Comprehensive sales summaries and operational metrics powered by Recharts.
- Historical Analysis: Deep-dive audit trails for every transaction and session modification.
- Framework: Next.js 16 (App Router)
- Engine: React 19 + TypeScript
- Styling: Tailwind CSS 4 + Radix UI
- State & Data: TanStack Query v5 + Zod
- Real-time: Laravel Echo + Pusher
- Persistence: PWA with Push Notification support
- UI Toolkit: Ant Design & Shadcn UI (Optimized)
- Node.js 20+
- Active instance of SpaSystem-API
# Enter the operational hub
git clone <repository-url>
cd SpaCashier
# Install dependencies
npm install
# Configure environment
# Copy .env.local.example to .env.local
# Set NEXT_PUBLIC_API_URL and Pusher/Reverb keys
# Launch development server
npm run dev- Unified CRUD Pattern: Leveraging the custom
useModelhook for standardized, type-safe data interactions. - Performance Optimized: Built-in asset optimization and server-side rendering for instant dashboard loads.
- Responsive Mastery: A mobile-first design that adapts seamlessly from tablet-based POS to desktop management.
SpaCashier is a core pillar of the Carlsson Spa Information System:
- SpaSystem-API: The enterprise backend engine.
- SpaBooking: The premium customer booking portal.
Designed for Productivity. Built for the Future. Licensed under MIT.