---
title: Developers
description: Internal engineering map for architecture, setup, ADRs, and the public API stack.
---

Internal documentation for engineers working on the Basenet rebuild. Partner-facing API guides live under [Partner](/partner).

## Start here

1. [Quickstart](/developers/quickstart) — apps, packages, and how to orient
2. [Architecture](/developers/architecture) — monorepo and runtime map (Mermaid)
3. [Application architecture](/developers/application-architecture) — transports → handlers → permissions/transactions/audit → repositories/providers
4. [Tenant isolation](/developers/tenant-isolation) — routing, database-per-tenant provisioning, fleet migrations and failure boundaries
5. [Workers and integrations](/developers/workers-integrations) — queues, adapters, retries, idempotency and dead letters
6. [Setup and checks](/developers/setup) — `pnpm dev` and day-to-day commands
7. [Operations and runbooks](/developers/operations) — every current runbook, grouped by purpose
8. [Real-tenant dev fixtures](/developers/tenant-fixtures) — boot on migrated Basenet-shaped data
9. [Public API & docs](/developers/public-api) — OpenAPI → Blume / Scalar / OpenWiki (Mermaid)
10. [Scalar API reference](/developers/scalar) — the live `/reference` viewer, auth reality, and which surface to use when
11. [Decisions & ADRs](/developers/decisions) — why boundaries exist
12. [Testing](/developers/testing) — unit, fleet, e2e expectations
13. [OpenWiki](/developers/openwiki) — generated wiki vs this browsable surface

## Local docs server

```bash
pnpm --filter @blinqx/docs dev
# → http://localhost:4322
```

Port **4322** is intentional (not Astro’s default 4321) so it stays clear of `web:3000` and `portal:3001`.

## Contract symlink

One OpenAPI artifact feeds every surface — see [Public API & docs](/developers/public-api) and [`docs/runbooks/docs-surfaces.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/runbooks/docs-surfaces.md).