Home
Commands

sourcey dev

Start a Vite dev server with SSR hot reload.

Starts a development server that watches your config, markdown files, and OpenAPI spec for changes. Pages re-render instantly on save.

Usage

sourcey dev [--port <number>]

Flags

FlagAliasDefaultDescription
--port-p4400Port to listen on

Behavior

The dev server reads sourcey.config.ts from the current directory and starts a Vite-powered SSR server. Changes to any of the following trigger a re-render:

  • Markdown pages (.md, .mdx)
  • OpenAPI spec files
  • MCP spec files (mcp.json)
  • Doxygen XML directories
  • sourcey.config.ts

The server performs full module graph invalidation on each change, ensuring every render reflects the latest state. There's no stale cache.

Tip

The dev server is for authoring and previewing. For production, use sourcey build and serve the static output.