Full-stack app for browsing cards and building decks: Spring Boot API, PostgreSQL, React frontend, Python scripts for data. Everything runs with Docker (or Podman). You get card browsing with pagination, deck list and composition (40 cards), card details, and Swagger API docs; the DB can be reset, migrated, and seeded from CSV.
Setup: For what to install (Docker, Podman, macOS/Homebrew, etc.), see Setup guide.
-
Prereqs: Docker + Compose — see Setup guide for install steps.
-
Run (from repo root):
docker compose up --build
-
Open:
Service URL Frontend http://localhost:8082 Swagger UI http://localhost:8080/swagger-ui.html Health http://localhost:8080/healthcheck First run runs migrations and seeds the DB from CSV automatically.
-
Tests (no DB):
docker compose --profile test build— see Tests for per-project commands and Podman.
| Service | URL | Description |
|---|---|---|
| Frontend | http://localhost:8082 | Cards grid, decks list; click a card for details, a deck for composition. |
| Swagger UI | http://localhost:8080/swagger-ui.html | Interactive API docs; try GET /cards, GET /decks. |
| Health | http://localhost:8080/healthcheck | Backend health check. |
| Project | Dockerfile | README |
|---|---|---|
| Backend | backend/Dockerfile | backend/README.md |
| Frontend | frontend/Dockerfile | frontend/README.md |
| Scripts | scripts/Dockerfile (stages: test, default; build from repo root) | scripts/README.md |
| When you want to… | Doc |
|---|---|
| Get running — setup, run app (Docker/Podman) | SETUP_AND_TESTS |
| Run tests — per-project, Podman, native, CI | TESTS |
| Use the app — URLs, Swagger, frontend usage | GETTING_STARTED |
| Work on code — backend/frontend locally (no containers) | DEVELOPMENT |
| Database — reset, migrate, seed, check data | DATABASE_MAINTENANCE |
| Schema — migrations, adding tables | DATABASE_MIGRATIONS |
| API — endpoints, examples | API_ENDPOINTS |
| Layout — repo structure | PROJECT_STRUCTURE |
| Problems — common errors and fixes | TROUBLESHOOTING |
| Stack — technologies and tools | TECHNOLOGY_STACK |
| License | LICENSE |
Screenshots in docs/screenshots/:
| Page | Preview |
|---|---|
| Cards |  |
| Card detail |  |
| Decks list |  |
| Deck composition |  |