MD Hub Secure

MD Hub Secure is a Go-first documentation platform for serving Markdown as secure, fast HTML with room for later sync, collaboration, and offline features.

Current Status

This repository now contains the Milestone 1 foundation scaffold:

• Go application server with chi routing, slog logging, config loading, and graceful shutdown
• SQLite/libsql-oriented data layer with startup migrations
• Markdown rendering pipeline with wiki-link rewriting, tag extraction, and SSR templates
• Content-addressed attachment storage with secure serving
• Preact + Vite frontend scaffold for later hydration-focused UI work
• Docker, Compose, CI, OpenAPI, and local development targets

Quick Start

Prerequisites

• Go 1.24+
• Node.js 24+
• npm 11+
• Docker (optional)
• CGO-capable toolchain for go-libsql

Run locally

make web-install
make web-build
make server-run

The server listens on http://localhost:8080 by default.

Common commands

make server-test
make server-build
make docker-build
make ci

Configuration

Configuration can come from:

1. config.json via MD_HUB_CONFIG
2. environment variables

Supported variables:

• MD_HUB_SERVER_ADDR
• MD_HUB_DATABASE_PATH
• MD_HUB_DATABASE_PRIMARY_URL
• MD_HUB_DATABASE_AUTH_TOKEN
• MD_HUB_CONTENT_SOURCE_DIR
• MD_HUB_CONTENT_STORE_DIR
• MD_HUB_WEB_DIST_DIR
• MD_HUB_LOG_LEVEL

Noted Gaps

• The docs describe both a single-binary system and a separate Vite/Preact app. This implementation keeps the Go server as the primary runtime and treats the web app as compiled static assets.
• The docs call for golang-migrate, but the current foundation uses an internal migration runner while go-libsql integration details are validated.
• The sync docs describe JSON messages while the Milestone 1 layout mentions a protobuf package; both are preserved in packages/protocol/ pending a later protocol lock.