Your schema. Your docs.

Protobuf → MDX · Built for Starlight

Give your Connect API a home alongside the rest of your documentation. Generate linked RPC contracts, JSON examples, and typed clients as ordinary MDX.

Add to your docs →Explore the example

One schema → a reference that belongs in your docs

shipping/v1/shipping.proto

service ShipmentService {
  rpc GetShipment(GetShipmentRequest)
    returns (GetShipmentResponse);
}

reference/api/

GetShipment

Unary RPC · HTTP / JSON · TypeScript · Go

MethodRequestResponse

Everything in one place

Your guides explain the workflow. Your reference explains the contract. Readers move between them with the same navigation, search, and theme.

Application guidesFollow a shipment workflow from authored prose into the generated contract.

API referenceExplore services, methods, messages, and enums from the complex sample schema.

Connect protocolUnderstand JSON and Protobuf encoding, streaming, errors, and metadata.

Complex schemaSee how maps, oneofs, nested messages, and well-known types become documentation.

One schema, both ways to call

The example Shipping API exposes the same methods to direct HTTP/JSON callers and generated RPC clients. Each method page shows its Protobuf signature, Connect endpoint, request and response contracts, and supported examples.

Try GetShipment for a unary call, or WatchShipment for server streaming.

A normal documentation project

The introduction, workflow guide, and protocol explanation are authored MDX. The pages under API reference are generated MDX. They use the same sidebar, search, typography, themes, and deployment.

Content	Location
Authored guides	src/content/docs/guides/
Generated reference	src/content/docs/reference/api/
Site configuration	Your existing astro.config.mjs

Reviewable by design

Generated pages contain real headings, descriptions, tables, and code blocks. You can commit them for review or generate them in CI before astro build. Wirelit records the files it owns and checks for edits before replacing or removing them.

This site documents a local fixture API. Start the example server from the repository before running its requests.