Hypernext

Multi-Protocol MDX Document Server and IndieWeb Publishing Engine

Hypernext transforms MDX files into a unified interface accessible via HTTP, REST API, Gemini, Gopher, Spartan, NEX, Text Protocol, Finger, RSS, PDF, and EPUB. It runs as a single Node.js process with zero external daemons.

Features

• Multi-Protocol — Serve content over HTTP, Gemini, Gopher, Spartan, NEX, Text, and Finger simultaneously
• MDX Powered — Write in Markdown with JSX components, rendered to every protocol
• IndieWeb Ready — IndieAuth OAuth2, Micropub, WebFinger, ActivityPub Actor/Outbox
• POSSE Syndication — Auto-publish to Mastodon and Bluesky
• Full-Text Search — FTS5-powered search across all documents
• PDF & EPUB — Generate downloadable books and documents
• MCP Server — Model Context Protocol tools for AI agent access
• IPFS Integration — Content-addressed pinning and gateway links
• TUI Editor — Terminal-based content editor with command palette
• Email Newsletter — Subscriptions, digests, and contact forms
• AI Features — Semantic search, auto-tagging, alt text generation
• Comment Moderation — Spam detection, blocklist, hide/unhide
• Scheduled Publishing — Future-dated content with automatic visibility
• Single Process — SQLite + in-memory cache, no Redis or Elasticsearch needed

Documentation

• Getting Started — Installation, configuration, writing content
• API Reference — REST API endpoints
• Customization — Configuration reference
• Protocol Servers — HTTP, Gemini, Gopher, Spartan, NEX, Text, Finger
• IndieWeb Features — IndieAuth, Micropub, WebFinger, ActivityPub
• IPFS Integration — Content pinning and gateway
• Comment Moderation — Spam, blocklist, hide/unhide
• Scheduled Publishing — Future-dated content
• POSSE Syndication — Mastodon and Bluesky
• Email & Newsletter — Subscriptions, digests, contact forms
• AI Features — Semantic search, auto-tagging, moderation
• MCP Tools — AI agent tool reference
• TUI Editor — Terminal-based content editor
• Deployment — Docker Compose, CLI, CI/CD

Quick Start

npx hypernext init
cd my-site
npx hypernext

Supported Protocols

Protocol	Port	Description
HTTP	8080	Web interface with Microformats2
Gemini	1965	Gemini protocol with TLS
Gopher	70	Classic Gopher protocol
Spartan	300	Spartan protocol
NEX	1900	Headerless raw protocol
Text	5011	Text Protocol with status codes
Finger	79	Finger protocol for author info