Skip to content

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, parsed into a common IR that all renderers translate to their protocol format
  • 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
  • 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 ​

Quick Start ​

bash
npx hypernext init
cd my-site
npx hypernext serve

Supported Protocols ​

ProtocolPortDescription
HTTP8080Web interface with Microformats2
Gemini1965Gemini protocol with TLS
Gopher70Classic Gopher protocol
Spartan300Spartan protocol
NEX1900Headerless raw protocol
Text5011Text Protocol with status codes
Finger79Finger protocol for author info