Quick Start¶

Project structure¶

packytrace/
├── client/
│   └── web-app/                 # SvelteKit frontend
├── contracts/                   # cross-service event contracts
├── deployment/                  # Docker Compose and infrastructure setup
├── docs/                        # living documentation source
├── services/                    # seven independently deployed services
├── Makefile                     # development command entry point
├── mkdocs.yml                   # documentation configuration
└── requirements-docs.txt        # documentation dependencies

Available commands¶

make help

Common commands:

make web         # Run the frontend development server
make docs        # Run the documentation development server
make up          # Start the full stack and follow its logs
make health      # Show container health once
make logs        # Follow container logs
make check       # Run the fast local guardrails
make smoke       # Verify the complete container stack
make ci          # Run the complete CI suite locally
make clean       # Remove generated build output

make up waits until every container is healthy, then follows their logs. Pressing Ctrl+C stops following but leaves the containers running; use make down to stop them. Prefer make up-detached to start without attaching. Commands install their dependencies when necessary.