feat: bootstrap foundation application

README.md

@@ -0,0 +1,68 @@
+# 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
+
+```bash
+make web-install
+make web-build
+make server-run
+```
+
+The server listens on `http://localhost:8080` by default.
+
+### Common commands
+
+```bash
+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.
+