Getting started
Installation
Prepare the local toolchain and start SmartGare's infrastructure, backend, frontends, and documentation.
Prerequisites
| Tool | Version or requirement |
|---|---|
| Java | 25 |
| Maven | Compatible with the multi-module build |
| Node.js | 22 or newer |
| pnpm | 11.5.2 through Corepack |
| Bun | Required only for developer-docs |
| Docker | Running for local services and Testcontainers |
Backend infrastructure
From smartgare-services:
docker compose -f infra/local/docker-compose.local.yaml up -d| Service | Local port |
|---|---|
| PostgreSQL | 5432 |
| Redis | 6379 |
| Kafka | 9092 |
| Keycloak | 9002 |
Backend application
mvn -pl product/apps/server -am -DskipTests spring-boot:runThe API listens on http://localhost:8080. OpenAPI is available at
/v3/api-docs and Swagger UI at /swagger-ui.html.
Frontend applications
From smartgare-frontend:
corepack enable
pnpm install
pnpm dev| Application | Port | Runtime |
|---|---|---|
| Back-office | 5101 | TanStack Start, SSR |
| Supervision | 5102 | Vite SPA |
| Counter | 5103 | Vite SPA; Tauri shell planned |
Developer documentation
From smartgare-docs:
bun install
bun run devOpen http://localhost:3000.
Quality gates
mvn test
mvn verify
mvn spotless:applymvn verify uses Testcontainers and requires Docker.