developer.apievangelist.com — Developer Portal

developer.apievangelist.com is the developer portal for the API Evangelist network — sixteen years of API research documented as one REST API and one MCP server. Built with Zudoku.

Live site: https://developer.apievangelist.com

What's in this repo

zudoku.config.ts — site config: navigation, theme, and the OpenAPI contracts that drive the references
apis/ — the source of truth for both OpenAPI contracts (Network API + Governance & Discovery API)
pages/ — the Markdown/MDX documentation pages
scripts/generate-well-known.mjs — generates the RFC 9727 API catalog at /.well-known/api-catalog and copies the contracts into public/apis/; runs as part of prebuild
public/ — static assets served from the site root (generated output here is gitignored)

Surface	Where	Docs
Network API	`https://api.apievangelist.com/v1`	`/api`
Governance & Discovery API	`https://api.apievangelist.com/v1/governance`	`/governance-api`
MCP server	`https://mcp.apievangelist.com/mcp`	`/mcp-server`

The API and MCP server themselves live in apievangelist-aws.

npm install
npm run dev     # runs prebuild, then zudoku dev
npm run build   # runs prebuild, then zudoku build → dist/