An open-source laundromat web app for small businesses and developers
Sunshine Laundrymat is a full-stack web application built with React, FastAPI, and SQLite. It’s designed as both a ready-to-deploy laundromat management solution and a developer-friendly boilerplate that can be adapted for other service-based businesses.
To empower small businesses and developers by providing a reusable, modern web app template that helps them quickly launch their services online — without needing to build everything from scratch.
Build an open, customizable platform that balances simplicity and scalability — making it easy for anyone to deploy, customize, and extend for their own use cases.
| Layer | Technology |
|---|---|
| Frontend | React |
| Backend | FastAPI |
| Database | SQLite (default) |
| Deployment | Docker & Docker Compose |
- 🧺 Service listings (Wash & Fold, Ironing, Pickup & Delivery)
- 👤 User dashboard with credits
- 📅 Booking and scheduling
- 💬 Notifications and order tracking
- ⚡ FastAPI backend with RESTful endpoints
- 🪶 Lightweight SQLite database for portability
- 🐳 One-command Docker deployment
- Docker
- Docker Compose
# Clone the repo
git clone https://github.com/<your-username>/sunshinelaundrymat.git
cd sunshinelaundrymat
# Run the app
docker compose upAccess the app at: http://localhost:3000
Frontend (React)
↓ REST API
Backend (FastAPI)
↓
Database (SQLite)
- React frontend handles the user interface and booking logic.
- FastAPI backend manages service data, user sessions, and communication between frontend and database.
- SQLite serves as a lightweight local database (can later be replaced with PostgreSQL or MySQL).
Sunshine Laundrymat can be used as a starter boilerplate for other small service businesses — like carwash, tailoring, cleaning, or delivery services.
Feel free to:
- Fork this repository
- Customize the UI and routes
- Swap out SQLite for a cloud database
- Extend APIs for your business logic
Pull requests are welcome! If you’d like to suggest a feature or fix a bug, please open an issue first to discuss what you’d like to change.
This project is licensed under the MIT License — you’re free to use, modify, and distribute it.
Created with ❤️ by Robby — because small businesses deserve simple digital tools.