One rail. One key. Your blog is live.

What you need

• ✓A domain you own — DNS resolves, serves public HTML, not behind an auth wall.
• ✓An email address.
• ✓A storage mode pick: hosted (simplest — we store articles, your frontend fetches via public API) or one of supabase, pocketbase, firebase, appwrite, mongodb (we write to your DB — you supply creds).
• !Your site needs real content. An admission gate rejects empty, redirecting, or thin-content domains.

The install rail

Base URL: https://api.networkr.dev

The install is a server-driven state machine. Start with POST /api/install, then follow each next_step envelope by POSTing to /api/install/:token/step. The token lives 24h. The 9 steps fire in order and only ask for what they need.

{
  "domain": "example.com",
  "email":  "user@example.com"
}

{
  "install_token":  "<token>",
  "seo_score":      72,
  "audit":          { "issues": [...], "brand_detected": {...}, "database_detected": {...} },
  "next_step": {
    "id":            "fix-loop" | "flavour",
    "body_template": { ... },
    "api_call":      { "method": "POST", "path": "/api/install/<token>/step" }
  }
}

{
  "step_id":      "flavour",
  "flavour":      "professional" | "casual" | "technical" | "founder",
  "author_name":  "Your Real Name",
  "blog_mode":    "production",
  "author_bio":   "optional short bio",
  "accent_color": "#8FBCBB",
  "niche":        "optional"
}

{
  "sample_article": { "title": "...", "body_html": "...", "cover_image": "data:..." },
  "preview_url":    "/preview/<token>",
  "preview_inline": true,
  "next_step":      { "id": "activate", ... }
}

{
  "step_id":              "activate",
  "db_type":              "hosted",
  "approval_required":    false,
  "approval_window_hours": 2
}

{
  "site_id":    "example-com",
  "network_id": "...",
  "api_key": {
    "key":    "nwk_live_<32 hex>",
    "prefix": "nwk_live_abcd1234",
    "notice": "Store this key now — it will never be shown again."
  },
  "approval":   { "applied": false },
  "next_step":  { "id": "verify", ... }
}

Save the install to your repo

Write these three variables to .env.local at the project root (the done envelope returns them under save_to_env):

NETWORKR_API=https://api.networkr.dev
NETWORKR_SITE_ID=<site_id from activate>
NETWORKR_KEY=<api_key.key from activate>

Ensure .env.local is in .gitignore. Optionally drop a copy of /brief.md at .networkr/AGENT.md so future agents in the repo find the install context.

Verify the install

Authorization: Bearer <api_key.key>

Returns a 10-item checklist with statuses (ok / warning / missing), each item carrying the exact API call to fix it if needed, plus a next_step object.

Hosted mode — render the blog

If you picked hosted, your frontend fetches posts from these public endpoints (no auth):

Reference implementation (Next.js 16): github.com/HEIMLANDR/networkr/tree/main/frontend/src/app/blog. Adapt for your framework — the API is framework-agnostic.

Wire up your build hook

When your site deploys through a static host (Netlify, Vercel, Cloudflare, Render, Fly, GitHub Actions), Networkr needs a build hook URL to trigger rebuilds on every new post. Get the URL from your host's dashboard, then:

Authorization: Bearer <key>
Content-Type: application/json

{ "build_hook_url": "https://api.netlify.com/build_hooks/..." }

Verify with POST /api/sites/<site_id>/build-hook/test.

Hard rules

• ✗Never invent endpoints. Use only what this page and /docs list. Unknown routes return 404.
• ✗Never edit published posts. Not supported. To change a post: DELETE /api/sites/<id>/blog/posts/<slug> then regenerate.
• !The tenant key scopes to the network, not the site. Reuse it across sibling sites on the same email.
• !Install token expires in 24h. On 410, restart with POST /api/install.
• !Respect rate limits. 429= wait 60s, retry once. Don't loop.