This guide is the fastest path to a fully running La Comanda instance on your local machine. Because the entire application — React frontend, Express backend, and MySQL database — is containerized with Docker Compose, you do not need to install Node.js, MySQL, or any other runtime directly on your system. Follow the steps below in order and you will have all three services running simultaneously from a single command.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/JAQA20/Paradigmas-G3/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites — make sure you have these before starting:
- Docker Desktop (with the WSL2 backend enabled on Windows)
- Git — to clone the repository
- A free Clerk account at clerk.com — needed to generate the publishable API key used for authentication
Install WSL2 on Windows (Windows users only)
Docker Desktop on Windows requires WSL2 (Windows Subsystem for Linux) for optimal performance. Open PowerShell as Administrator and run:After the command completes, restart your computer. A terminal window configuring Ubuntu may appear on reboot — let it finish, then close it. macOS and Linux users can skip this step.
Install Docker Desktop
Download and install Docker Desktop from the official page:https://www.docker.com/products/docker-desktop/During installation on Windows, ensure the “Use WSL 2 instead of Hyper-V” checkbox is selected. Once installed, open Docker Desktop from your Start menu and wait until the whale icon in the bottom-left corner turns green and shows “Engine Running” before proceeding.
Clone the repository
Open a terminal (PowerShell, Git Bash, or your system terminal) and run:All subsequent commands in this guide should be run from inside the
LaComanda-SaaS-Azul directory.Configure your Clerk publishable key
La Comanda uses Clerk for authentication. You need to provide your Clerk publishable key before the login screen will render. Create the environment file for the frontend:Open Save the file. Docker Compose will inject this variable into the frontend container at build time via the Vite environment system.
frontend/.env.local in any text editor and add the following line, replacing the placeholder with the key from your Clerk dashboard under API Keys:Start all services with Docker Compose
With Docker Desktop running in the background and your terminal inside The first run will take several minutes as Docker pulls the MySQL 8.0 image, installs Node.js dependencies for both the frontend and backend, and compiles the TypeScript source. Subsequent starts (without
LaComanda-SaaS-Azul, start the full stack:--build) are significantly faster.Once all three containers are healthy you will see log output from all services:| Service | Container name | Address |
|---|---|---|
| React + Vite frontend | lacomanda_frontend | http://localhost:5173 |
| Express REST API | lacomanda_backend | http://localhost:3000 |
| MySQL 8.0 database | lacomanda_db | localhost:3306 (internal) |
Open the application
Navigate to http://localhost:5173 in your browser. You will be presented with the La Comanda login screen powered by Clerk. Sign in with the credentials you configured in your Clerk dashboard to access the full application.To verify the backend is healthy independently, visit http://localhost:3000/api/health — it should return:
Port Reference
| Service | Port | Description |
|---|---|---|
| Frontend | 5173 | React + Vite dev server |
| Backend API | 3000 | Express REST API |
| MySQL | 3306 | Database (internal, also exposed for DB clients) |
If ports 3000, 3306, or 5173 are already occupied on your machine (e.g., by XAMPP, Laragon, or another Node server), stop those local services before running
docker compose up --build so Docker can bind to those ports successfully.