Documentation Index
Landing page and reading-order guide for the API Workbench Pro documentation suite; links every other document and explains who each is for.
API Workbench Pro — Documentation Index
- Title: Documentation Index (landing page)
- Generated at: 2026-06-13
- Repository: api-workbench-pro
- Branch: main
- Revision: v0.9.0
- Audience: Everyone — new users, API designers, integration engineers, ops/SRE, tech leads, auditors, and procurement/security reviewers
- Confidence: high
- Related documents: BUSINESSSSYSTEMREFERENCE.md · USER_MANUAL.md · PROCESS_FLOWS.md · NAVIGATION_TREE.md · TECHNICAL_ARCHITECTURE.md · FEATURE_CATALOG.md · READINESS_PLATFORM.md · ROLEEPERMISSIONMATRIX.md · DATAAFLOWANDDENTITYREFERENCE.md · CHANGEEINTELLIGENCEAPPENDIX.md · DOCCGENERATIONREPORT.md · HELPPMENUMASTERFILE.json · ARCHITECTURE.md · GDPR.md · README.md
What is API Workbench Pro?
API Workbench Pro is an offline-first API integration workbench that covers the entire API
lifecycle — import → design → mock → map → run → govern → ship-readiness — inside a single
browser app. There is no backend, no account system and no sync service: every byte of your
workspace data lives in your own browser's localStorage. The vendor never receives it and has no
technical means to.
That single architectural choice is the product's flagship promise: **zero-egress, GDPR by
architecture**. Your specs, endpoints, mappings, runs, traces and audit log generate zero outbound
network traffic; the only times the app touches the network are three explicit, user-initiated flows
(a live request you Send, a spec you import from a URL, and a webhook you configured for a
scheduled run).
- Live app: <https://api-workbench-pro.lovable.app/>
- In-app help center: the Documentation Center at
/docsrenders this same documentation - Internal codename in the code: ApiBox (you will see
apibox.*storage keys).
New here? Jump to Start here — by persona for the fastest path to
being productive in your role.
The documentation set
Thirteen Markdown documents make up the help center. Every one is grounded in the real routes,
entities and code of API Workbench Pro (v0.9.0, with the v0.9.1 Readiness Platform Guide added on
top); verified facts are kept separate from inferred ones, and each document cross-links the others. The in-app Documentation Center (/docs) discovers and
renders these files; the Help Menu masterfile is the machine-readable
manifest that drives the in-app menu.
Newest addition (v0.9.1): the Readiness Platform Guide documents the
now ten-dimension Readiness Scorecard and the four dedicated readiness pages (API Inventory,
Resilience Lab, Agent Readiness, Compatibility Matrix) added since the v0.9.0 wave.
| # | Document | Audience | Summary |
|---|---|---|---|
| 1 | Documentation Index (this page) | Everyone | The landing page: what the product is, the full doc table, per-persona start paths, and pointers to /docs and the masterfile. |
| 2 | Business System Reference | Product, engineering, operations, support | The big-picture reference: what the product is, the value proposition, the module map, and how the lifecycle stages fit together as one system. |
| 3 | User Manual | End users, support, operations | End-to-end, operational walkthrough of the app — the shell (sidebar, command palette Ctrl/Cmd+K, g-key chords, theme, tour), every Workspace/Modeling/Runtime screen, and how to actually do each task. |
| 4 | Process Flows | Product, operations, support, engineering | The core end-to-end processes (import, design→scenario→run, mapping→review→lock, schema-change→CI gate, spec-watch→notify, readiness→PDF, gateway smoke, scheduled runs, evidence bundle, encrypted export, role/lock denial) as Mermaid flows with prose. |
| 5 | Navigation Tree | Support, product, engineering | The complete route map — every sidebar group, label and path, plus detail and public routes — as a navigable tree. |
| 6 | Technical Architecture | Engineering, architecture, security, devops | Tech stack, the offline-first/SSR architecture, the store and persistence model, the src/lib/checks engine contract, and local development. |
| 7 | Feature Catalog | Product, support, engineering | One reference section per route/module (what it is, who it's for, how to use it, what it persists), covering every screen in the navigation — including the Readiness Scorecard and the five check modules. |
| 8 | Role Permission Matrix | Product, support, security, engineering | The four roles (owner/editor/operator/viewer), the persona mapping, impersonation, production locks, mapping reviews, and the append-only audit log. |
| 9 | Data Flow & Entity Reference | Engineering, data, product | The domain entity model (src/domain/types.ts), where state lives (apibox.state.v5 + awp.* keys), the exactly-three outbound flows, and end-to-end data journeys. |
| 10 | Change Intelligence Appendix | Engineering, product, QA, support | Feature-evolution timeline (0.7.0 → 0.9.0), recurring bug classes, fragile/migration-sensitive areas, and the "do-not-rebreak" knowledge mined from the changelog and lessons file. |
| 11 | Help Menu Masterfile | Frontend, engineering, docs system | The machine-readable manifest that drives the in-app help menu: every document with its metadata, plus navigation/feature/process/role/entity indexes. |
| 12 | Documentation Generation Report | Maintainers, engineering | Provenance of this documentation set: scope analyzed, documents generated, Mermaid coverage, confidence assessment, evidence gaps, and recommendations. |
| 13 | Readiness Platform Guide | Tech Leads/Owners, designers, engineers, ops, security | Deep-dive on the ten-dimension Readiness Scorecard (how the weighted score and ship/caution/blocked verdict are computed) and the four dedicated readiness pages — API Inventory, Resilience Lab, Agent Readiness, Compatibility Matrix — with per-dimension rules and a step-by-step readiness workflow. |
The Readiness Scorecard (
/readiness) — now ten dimensions — and its dedicated check
surfaces (Governance & Lint, Security Posture, Trace Readiness, Drift Radar, Validation Engine,
API Inventory, Resilience Lab, Agent Readiness, Compatibility Matrix) are covered end-to-end in the
Readiness Platform Guide and enumerated in the
Feature Catalog; their end-to-end flows are in
Process Flows and their data/engine contract in
Technical Architecture.
Pre-existing provenance docs (preserved, cross-linked — not part of the numbered help set):
ARCHITECTURE.md, GDPR.md,
trust/security-overview.md,
trust/DPA-template.md. These are the source-of-truth provenance pages a
security or procurement reviewer reads; the help-center docs cross-link them and never duplicate
them.
Start here — by persona
API Workbench Pro is role-aware. You set your active role by impersonation in Settings
(/settings); each persona has a default role (see Role Permission Matrix).
Below is the fastest productive path for each.
API Designer (default role: editor)
You import specs and shape endpoints, schemas and scenarios.
- User Manual → the shell + the API Catalog & Import (
/catalog,/import) - Process Flows → Import OpenAPI and *Endpoint design → scenarios →
- Feature Catalog → Data Packs (
/data-packs), Scenarios - Feature Catalog → run a Governance & Lint (
/governance) pass on your
Integration Engineer (default role: editor)
You wire APIs together with field mappings and run scenario suites.
- User Manual → API Explorer (
/api-explorer) and Mapping Studio - Process Flows → Mapping build → review → production lock and *Schema
- Feature Catalog → Mapping Reviews (
/mapping-reviews), Prevalidation - Change Intelligence Appendix → understand which modules a spec
Ops / SRE (default role: operator)
You run, schedule, smoke-test and monitor — but cannot change locked production mappings.
- Feature Catalog → Environments (
/environments), Gateway Smoke - Process Flows → Gateway export → smoke and *Scheduled run tick →
- Feature Catalog → Drift Radar (
/drift-radar) and - Role Permission Matrix → what production locks deny you and why.
Tech Lead / Owner (default role: owner)
You own production locks, govern reviews, and decide what ships.
- Feature Catalog → the Readiness Scorecard (
/readiness) and its - Change Intelligence Appendix → the change-intelligence loop and
- Process Flows → Mapping → review → lock and Readiness check → PDF.
- Role Permission Matrix and GDPR.md → governance model
Auditor / Viewer (default role: viewer)
You inspect, verify and export evidence — read-only.
- Feature Catalog → Audit Log (
/audit), Trust Center (/trust). - Process Flows → Evidence bundle export (audit-grade).
- GDPR.md and trust/security-overview.md → the
- Data Flow & Entity Reference → verify the zero-egress claim
Procurement / Security reviewer
You assess risk before adoption.
- GDPR.md → GDPR Art. 5 / 25 / 32 mapped to architectural answers.
- ARCHITECTURE.md → the exactly-three outbound flows and the route map.
- trust/security-overview.md and trust/DPA-template.md.
- Data Flow & Entity Reference → the verifiable storage-key
The whole app at a glance
The navigation groups every route. Use this as a map; each module has a full section in the
Feature Catalog, and the complete route tree is in
Navigation Tree.
flowchart TD
subgraph WS[Workspace]
O["/ Overview"]
CAT["/catalog · Import"]
EXP["/api-explorer"]
GQL["/graphql"]
RT["/realtime"]
TMF["/tmf"]
end
subgraph MOD[Modeling]
DP["/data-packs"]
SC["/scenarios"]
MAP["/mappings"]
MR["/mapping-reviews"]
ERR["/errors"]
SD["/schema-diff"]
end
subgraph RUN[Runtime]
ENVR["/environments"]
PRE["/prevalidation"]
EXEC["/execution"]
GS["/gateway-smoke"]
CI["/ci-gate"]
SCH["/schedules"]
MF["/mock-forge"]
end
subgraph INTEL[Intelligence]
INS["/insights"]
CHI["/change-intelligence"]
OAI["/openai"]
AEX["/explorer"]
end
subgraph RDY[Readiness]
RScore["/readiness"]
GOV["/governance"]
SECP["/security-posture"]
TR["/trace-readiness"]
DR["/drift-radar"]
VE["/validation-engine"]
INV["/api-inventory"]
RL["/resilience-lab"]
AR["/agent-readiness"]
CM["/compatibility-matrix"]
end
subgraph GOVN[Governance]
AUD["/audit"]
TRUST["/trust"]
ENT["/enterprise"]
SET["/settings"]
HELP["/help · /docs"]
end
WS --> MOD --> RUN --> RDY
RUN --> INTEL
RDY --> GOVN*Diagram: the navigation groups (Workspace, Modeling, Runtime, Intelligence, Readiness, Governance)
and the rough left-to-right lifecycle flow. Detail routes (/api/$apiId,/api/$apiId/endpoint/$endpointId, advanced /import) and the public, full-bleed routes
(/welcome, /pricing) sit outside these groups.*
Where to read these docs
- In the app: open the Documentation Center at
/docs— it renders this exact docs - In the repo / on GitHub: browse the
docs/folder. Start with this index, then follow - Programmatically: the Help Menu masterfile lists every document
To learn how this documentation system is wired and how to extend it, see
docs/README.md.