# Meridian - Complete + Onboarding

$300 one-time. The whole API stack, plus a live session.

## What this is

A working, pinned Docker Compose stack for self-hosted API development and
testing. Not a link dump - the integration layer: services wired together,
environment template, quickstart, runbook, and a script that fetches the exact
upstream sources at pinned commits.

## Included

- All eight components
- 1:1 onboarding session
- Lifetime updates

## Components

| Component | Licence | Language | Role |
|---|---|---|---|
| hoppscotch | MIT | TypeScript | API client |
| bruno | MIT | JavaScript | Git-friendly API client |
| mockoon | MIT | TypeScript | Local mock API |
| wiremock | Apache-2.0 | Java | HTTP mock server for tests |
| mockserver | Apache-2.0 | Java | Programmable mock and proxy |
| prism | Apache-2.0 | TypeScript | Spec-driven mock and validation |
| traefik | MIT | Go | Dynamic reverse proxy |
| caddy | Apache-2.0 | Go | Web server with automatic TLS |
| kong | Apache-2.0 | Lua | API gateway |

## Quickstart

```bash
cp .env.example .env
docker compose up -d
./verify.sh
```

Endpoints:
- `mockoon` -> http://localhost:3000
- `wiremock` -> http://localhost:8080
- `mockserver` -> http://localhost:1080
- `prism` -> http://localhost:4010
- `traefik` -> http://localhost:8081
- `caddy` -> http://localhost:8082
- `kong` -> http://localhost:8000

Hoppscotch and Bruno are client apps - see `docs/` for how to run them.

## Getting the sources

```bash
./fetch-sources.sh ./sources
```

All components are MIT or Apache-2.0. See `ATTRIBUTION.md`.

## Requirements

- Docker Engine 24+ with the Compose v2 plugin
- 2 GB RAM for the starter tier, 8 GB with the gateway and platform

## Support

See `RUNBOOK.md`.