Developer & contributor docs

Everything you need to build on, test, and operate A-Market. New here? Start with Getting started, then keep the Cheatsheet open.

Get started

• Getting started — clone, install, and run the server (with or without auth) + the webapp.
• Cheatsheet — the everyday commands: every test suite, local server modes, tokens, REST calls.

Reference

• Architecture — the one backend, its two transports (MCP + REST), auth, and persistence.
• Features → code — every capability the platform offers, and exactly where it lives in the code.
• MCP tools — the full MCP tool catalogue, grouped by scope.
• REST API — the /v1 endpoint reference.
• Data models — the shared Zod schemas, enums, and OAuth scopes.

Operate

• Testing — the production-grade test & hardening suite (seeding → E2E → integration → load → security).
• Deploy — Terraform, the CI/CD pipeline, DNS, and the staging/prod VPS runbook.
• Operations — SSH, env editing, pgAdmin, Keycloak email, and connector testing.
• Roadmap (open items) — what's in progress, deferred, and known bugs.