๐ Introduction โ
KitchenAsty is a self-hosted, open-source restaurant ordering platform built with a modern TypeScript stack. It gives restaurant owners full control over online ordering, kitchen operations, reservations, and customer engagement โ without monthly SaaS fees.

โจ Key Features โ
- ๐ Online Ordering โ Delivery & pickup with guest checkout and scheduled orders
- ๐ณ Kitchen Display โ Real-time order board powered by Socket.IO
- ๐ Multi-Location โ Independent menus, hours, delivery zones, and staff per location
- ๐ณ Payments โ Stripe, PayPal, and cash with webhook-driven status updates
- ๐ Reservations โ Table booking with availability checks and party size validation
- โญ Reviews & Ratings โ Customer reviews with staff moderation
- ๐ Loyalty Program โ Points-based earn/redeem system
- ๐ท๏ธ Coupons โ Percentage, fixed, and free-delivery discounts
- โก Automation โ Event-driven rules for email, webhooks, and SMS notifications
- ๐ Analytics โ Revenue, order, and customer stats with date-range charts
- ๐ Internationalization โ 6 languages out of the box (EN, ES, FR, DE, IT, PT)
- ๐ ๏ธ Admin Dashboard โ Full back-office for managing every aspect of the platform

๐๏ธ Architecture Overview โ
KitchenAsty is a monorepo with four packages:
kitchenasty/
โโโ packages/server # Express + Prisma REST API
โโโ packages/admin # React admin dashboard (Vite)
โโโ packages/storefront # React customer-facing app (Vite)
โโโ packages/shared # Shared types and utilities
โโโ prisma/ # Database schema and seeds| Layer | Technology |
|---|---|
| API Server | Node.js 22, Express, TypeScript |
| Database | PostgreSQL 16 with Prisma ORM |
| Real-Time | Socket.IO |
| Admin UI | React 18, Vite, Tailwind CSS, Recharts |
| Storefront | React 18, Vite, Tailwind CSS, i18next |
| Payments | Stripe, PayPal |
| Auth | JWT, Passport.js (Google & Facebook OAuth) |
| Containerization | Docker, Docker Compose |
| CI/CD | GitHub Actions |
๐ Next Steps โ
- ๐ Requirements โ What you need before installing
- ๐ณ Install with Docker โ Fastest way to get running
- ๐ง Install Manually โ For development or custom setups