🚗 Mobile Car Wash Manager

A cross-platform Progressive Web App (PWA) for managing mobile car wash business operations. Works on PC, mobile, and tablet devices.

🌐 Live Demo: View on GitHub Pages

📱 Install: Visit the live URL and click "Install App" on your device!

⚠️ First Time Setup

You need Node.js installed first!

If you see "unable to preview" or "node is not recognized":

1. Open INSTALL_NODEJS.txt in this folder
2. Follow the simple step-by-step instructions
3. Restart your computer after installing
4. Then double-click start.bat

🚀 Starting the App - Multiple Easy Ways!

🎯 Easiest: Visual Guide

Double-click SIMPLE_START.html - Opens a visual guide in your browser with all methods!

Method 1: VS Code (If you have it)

1. Open this folder in VS Code
2. Press Ctrl + ` (backtick) to open terminal
3. Type: npm install (first time only)
4. Type: npm run dev
5. Done!

Method 2: Right-Click Menu

1. Right-click in this folder → "Open in Terminal"
2. Type: npm install (first time only)
3. Type: npm run dev
4. Open browser to http://localhost:3000

Method 3: One Command

Open terminal here and type:

npm install && npm run dev

Method 4: Simple Scripts

• start-simple.bat - Ultra-simple version
• start-simple.ps1 - PowerShell version

📖 See EASIEST_WAY.txt for detailed instructions

Features

• Dashboard: Overview of daily operations, revenue, and upcoming appointments
• Appointment Management: Schedule, track, and manage customer appointments
• Customer Database: Store and manage customer information
• Service Management: Define and price your car wash services
• Employee Management: Track staff members and their assignments
• Inventory Tracking: Monitor supplies with low stock alerts
• Route Planning: Plan daily routes for employees
• Reports & Analytics: View business performance metrics

Technology Stack

• React 18 - UI framework
• TypeScript - Type safety
• Vite - Build tool
• Tailwind CSS - Styling
• Zustand - State management with persistence
• React Router - Navigation
• date-fns - Date utilities
• Lucide React - Icons
• PWA - Progressive Web App capabilities

Data Storage

All data is stored locally in the browser using localStorage. This means:

• Data persists between sessions
• Works offline
• No backend server required
• Data is private to your device

🌐 Host Online for Testing

Quickest Way (2 minutes)

1. Double-click QUICK_HOST.bat - Opens Netlify Drop
2. Drag the dist folder (builds automatically if needed)
3. Get instant link - Your app is live online!
4. Test on any device - Share the link

📖 See HOST_ONLINE_NOW.txt for detailed instructions

Alternative: Expose Local Dev Server

For testing while developing (no build needed):

• See EXPOSE_LOCAL.txt for LocalTunnel/ngrok setup
• Perfect for real-time testing during development

🚀 Deploy Online (PWA)

Quick Deploy (2 minutes)

1. Build the app: Double-click build.bat
2. Deploy to Netlify (easiest):
   • Go to: https://app.netlify.com/drop
   • Drag the dist folder
   • Get instant URL - your app is live!

Other Deployment Options

• Netlify: See NETLIFY_DEPLOY.txt (recommended - easiest)
• Vercel: See VERCEL_DEPLOY.txt (great for auto-deployments)
• GitHub Pages: See GITHUB_DEPLOY.txt (free, requires GitHub)

📖 See DEPLOY.txt for complete deployment guide

Updating Your Live App

1. Make changes to your code
2. Run build.bat again
3. Upload the new dist folder
4. App updates instantly!

Reverting to Previous Version

See REVERT.txt for instructions on going back to a previous version.

All hosting services keep previous deployments, so you can always revert!

PWA Icons

For full PWA functionality, add icon files to the public directory:

• pwa-192x192.png - 192x192 icon
• pwa-512x512.png - 512x512 icon
• apple-touch-icon.png - 180x180 for iOS

You can generate these from a single high-resolution logo using online tools or image editors.

Troubleshooting

If you have issues:

• Open TROUBLESHOOTING.txt for common problems and solutions
• Make sure Node.js is installed (see INSTALL_NODEJS.txt)
• Restart your computer after installing Node.js

License

MIT