Project

MdWrk

A typed content and site system oriented around explicit contracts, reusable lander infrastructure, and inspectable publication surfaces.

Principal engineer and architecture leadOngoing

MdWrk is a concrete example of treating publishing as an architectural system rather than a theme. The value is not only in page rendering. It is in keeping content contracts, route semantics, discovery output, and deployment surfaces aligned enough to review as one system.

Context

Publishing systems often separate content, rendering, discovery metadata, and deployment state into disconnected tools that are difficult to reason about as one surface.

Constraints

Constraint

The system must support multiple sites with shared infrastructure.

Constraint

Content needs typed structure instead of ad hoc blobs.

Constraint

Discovery artifacts must remain reproducible from the repo.

Architecture

Architecture

Typed content packs define site-level truth.

Architecture

React and static generation provide the presentation layer.

Architecture

Docker and provider-backed desired state keep publication inspectable.

Outcomes

Outcome

A reusable site substrate for multiple public domains.

Outcome

Clear separation between content contracts and presentation shells.

Outcome

Better alignment between writing surfaces and deployment evidence.

Links

Related essays

Related worldviews