Skip to content

Build Log — Devops

devops | in progress

SDK generation and typed clients.

A placeholder for the eventual write-up on generating a versioned TypeScript SDK from a .NET OpenAPI surface, publishing it to a private feed, and consuming it from a Next.js frontend without breaking on every release.

Status: draft outline. Will be replaced with a concrete walk-through once the SDK pipeline has settled.

Planned sections

OpenAPI as the contract — what the .NET side commits to.
Pipeline shape — manual trigger, semantic-release, feed publish.
Consuming the SDK from Next.js — install, lockfile, Docker.
Local-only iteration — copy-into-node_modules workflow.
Versioning policy — breaking changes, deprecation, rollouts.

Open questions

How aggressive should auto-versioning be on a tiny team?
What's the right way to surface SDK deprecations to consumers?
When is a hand-written client better than a generated one?