iflow-mcp/nowbind-nowbind

Write for humans. Feed the machines.

The open-source blogging platform where every post is both a beautiful article and a structured AI-agent feed.

---

What is NowBind?

Most blogging platforms treat AI as an afterthought. NowBind is built from the ground up so every published post automatically becomes:

• A beautifully rendered article for readers
• Structured markdown with YAML frontmatter for LLMs
• AI summaries and keywords for agent consumption
• An MCP resource for Claude and other AI assistants
• An llms.txt entry following the llmstxt.org spec

Your blog becomes a knowledge base that both people and AI can read, search, and reference.

Features

Writing – Markdown editor with live preview, GFM support, tags, drafts, reading time estimation, and full-text search (PostgreSQL tsvector + trigram fuzzy matching).

Auth – Google & GitHub OAuth, passwordless magic links via Gmail, JWT + refresh tokens with HttpOnly cookies.

Social – Follow authors, likes, bookmarks, threaded comments, personalized feed, in-app + browser push notifications (VAPID/Web Push), share buttons.

Analytics – View tracking, unique visitors, AI vs human classification, stats dashboard with timeline/top posts/referrers.

AI Integration – Agent REST API (API key auth), MCP server (JSON-RPC 2.0), llms.txt / llms-full.txt, structured markdown output.

PWA – Installable, offline fallback, service worker caching (Serwist), push notifications.

Feeds – RSS 2.0, Atom 1.0, JSON Feed 1.1.

SEO – Open Graph, Twitter Cards, JSON-LD, canonical URLs, dynamic sitemap, robots.txt.

Why Switch from Medium to NowBind?

• Own your stack: self-hostable codebase, open data model, no platform lock-in.
• Own your content: import Medium exports and publish from your own domain and database.
• AI-native publishing: every post is readable for humans and consumable by agents via MCP, Agent API, and llms.txt.
• Extensible by design: OSS roadmap, public issues/discussions, and contributor-friendly architecture.

Migration guide: docs/launch/migrate-from-medium.md
In-app migration page: /docs/migrate

Tech Stack

Quick Start

Prerequisites

• Go 1.25+, Node.js 20+, PostgreSQL 15+ (running on your host)

1. Clone & set up

git clone https://github.com/nowbind/nowbind.git
cd nowbind

2. Start PostgreSQL locally

Make sure your host Postgres service is running and accessible on port 5432. NowBind does not manage Postgres as a Docker service in this repo.

3. Run the backend

cd backend
cp .env.example .env    # edit with your config
go mod download
go run cmd/server/main.go -migrate
go run cmd/server/main.go

4. Run the frontend

cd frontend
npm install

Create frontend/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:8080/api/v1
NEXT_PUBLIC_SITE_URL=http://localhost:3000
BACKEND_URL=http://localhost:8080

npm run dev

Or use make dev from the project root to run backend + frontend once Postgres is already running.

Environment Variables

Backend (.env)

Frontend (.env.local)

OAuth, email, and push are all optional – the platform works without them.

Project Structure

nowbind/
├── backend/
│   ├── cmd/server/           # Entry point
│   ├── internal/
│   │   ├── config/           # Env config
│   │   ├── database/         # PostgreSQL + migrations (7 files)
│   │   ├── handler/          # HTTP handlers
│   │   ├── middleware/       # Auth, API key, CORS, logging
│   │   ├── mcp/              # MCP server (JSON-RPC 2.0)
│   │   ├── model/            # Domain models
│   │   ├── repository/       # Data access layer
│   │   ├── router/           # Route definitions
│   │   └── service/          # Business logic
│   └── pkg/                  # JWT, slug, gravatar utils
│
├── frontend/
│   ├── app/                  # Next.js App Router
│   │   ├── (main)/           # Public: explore, post, author, docs, search
│   │   ├── (auth)/           # Login, OAuth callback
│   │   ├── (dashboard)/      # Editor, stats, settings, notifications
│   │   └── sw.ts             # Service worker
│   ├── components/           # Layout, post, social, PWA, UI (shadcn)
│   └── lib/                  # API client, auth context, hooks, types
│
├── docker-compose.yml
├── Makefile
├── API_TESTING.md
├── CONTRIBUTING.md
├── NOTICE
└── LICENSE

Agent API

AI-optimized endpoints with API key auth. Create keys from the dashboard or /api-keys page.

curl -H "Authorization: Bearer nb_your_api_key" \
  https://nowbind.com/api/v1/agent/posts

MCP Server

NowBind exposes an MCP server for AI assistants like Claude.

{
  "mcpServers": {
    "nowbind": {
      "url": "https://nowbind.com/mcp/",
      "headers": {
        "Authorization": "Bearer nb_your_api_key"
      }
    }
  }
}

Resources: nowbind://posts, nowbind://posts/{slug}, nowbind://authors, nowbind://tags, nowbind://feed

Tools: search_posts, get_post, list_posts, get_author

API Endpoints

Full interactive docs at /docs on any running instance.

Database

Migrations run automatically on startup (idempotent). Run manually with:

cd backend && go run cmd/server/main.go -migrate

Neon databases are auto-detected and configured with appropriate pooling.

Development

make dev              # Start backend + frontend (requires local Postgres)
make dev-backend      # Go backend
make dev-frontend     # Next.js dev server
make db               # Reminder: Postgres is host-managed
make migrate          # Run migrations
make build-backend    # Build Go binary
make build-frontend   # Build Next.js
make lint             # Lint frontend
make clean            # Clean build artifacts

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

License

GNU Affero General Public License v3.0 — this is copyleft software. If you modify and host NowBind as a network service, you must release your modifications under AGPL-3.0. See the NOTICE file for attribution requirements.