Fast Food
FastFood Application made with Spring Boot as a personal project.
Install / Use
/learn @LeooZeballos/Fast FoodREADME
FastFood 🍔
FastFood is a modern, full-stack fast food management application designed for efficiency and scalability. It features a decoupled architecture with a robust Spring Boot backend and a high-performance React frontend.
🌟 Key Features
- 📦 Decoupled Architecture: Independent Spring Boot 3.4.4 backend and Vite + React 19 frontend.
- 🌎 Bilingual Support: Fully localized in English and Spanish.
- 📊 Order Management: Real-time order lifecycle tracking (Take, Prepare, Complete, Cancel).
- 🏢 Multi-Branch Support: Manage multiple restaurant locations.
- 🍔 Menu & Inventory: Flexible menu creation and inventory tracking.
- 🎨 Modern UI: Built with Tailwind CSS, Shadcn UI, and Lucide icons for a premium feel.
- ⚡ High Performance: Optimized with Spring Virtual Threads and Caffeine caching.
🛠️ Technology Stack
Backend
- Java 17+ (with Virtual Threads support)
- Spring Boot 3.4.4
- Spring Data JPA & Hibernate
- PostgreSQL (with Flyway migrations)
- Spring Actuator (for monitoring)
- JUnit 5 & Mockito (Testing)
Frontend
- React 19
- TypeScript
- Vite 6
- Tailwind CSS & Shadcn UI
- TanStack Query (Data fetching)
- i18next (Localization)
- Vitest & Playwright (Testing)
🚀 Getting Started
Prerequisites
- Java 17 or higher
- Node.js 18+ & pnpm (or npm/yarn)
- Docker & Docker Compose
- PostgreSQL (if running locally without Docker)
Quick Start with Scripts
The project includes automated scripts to manage services in the background:
-
Clone the repository:
git clone https://github.com/LeooZeballos/fast-food.git cd fast-food -
Start all services (Database, Backend, and Frontend):
./scripts/start-all.sh -
Access the application:
- Frontend: http://localhost:4000
- Backend API: http://localhost:4080
- API Docs: http://localhost:4080/swagger-ui.html
-
Stop all services:
./scripts/stop-all.sh
Manual Setup
Backend
mvn spring-boot:run
Configurable via src/main/resources/application.properties.
Frontend
cd frontend
pnpm install
pnpm dev
🤖 AI Agent Ready
This project is optimized for AI agents (like Gemini CLI or Claude). Check AGENTS.md for mandatory workflows, service management rules, and debugging capabilities.
📸 Screenshots
Manage Orders
Take Orders
Manage Products
📜 License
MIT License - Copyright (c) 2023-2026 Leonel Zeballos
