{
  "@type": "help_guide",
  "id": "cms-git-vercel",
  "title": "Publishing to a GitHub + Vercel site",
  "kind": "feature",
  "summary": "For a site built in a GitHub repository and hosted on Vercel, Nexus publishes each article as a pull request. The piece goes live when someone reviews the Vercel preview and merges.",
  "aliases": [
    "git vercel",
    "github site",
    "vercel blog",
    "next.js blog",
    "publish by pull request",
    "connect github"
  ],
  "engine": "content",
  "agents": [],
  "related": [
    {
      "id": "publishing",
      "page": "https://nexus.effiqs.com/help/publishing"
    }
  ],
  "reviewed": "2026-10-15",
  "sections": [
    {
      "heading": "What it does",
      "key": "what-it-does",
      "markdown": "For a site built in a GitHub repository and hosted on Vercel, Nexus publishes each article as a pull request. The piece goes live when someone reviews the Vercel preview and merges."
    },
    {
      "heading": "Set it up",
      "key": "set-it-up",
      "markdown": "1. **\"Connect GitHub for them.\"** Nexus posts an install link for its GitHub app.\n2. ✋ Someone with access to the client's repository installs it on that repository.\n3. Tell Nexus which repository to publish to: **\"Set the git publishing target to owner/name.\"**\n4. **\"Check the GitHub connection.\"**"
    },
    {
      "heading": "Use it",
      "key": "use-it",
      "markdown": "- **\"Publish [title] to the site.\"** Nexus opens the pull request and posts the preview link.\n- ✋ Review the preview and merge.\n- After merging: **\"[title] is live at [url].\"** That triggers the social cross-posts."
    },
    {
      "heading": "Troubleshooting",
      "key": "troubleshooting",
      "markdown": "- **The message says \"Git auth failed.\"** The credential expired or can't see the repository. The message says which."
    },
    {
      "heading": "Prompts",
      "key": "prompts",
      "markdown": "- \"Connect GitHub for them.\"\n- \"Set the git publishing target to owner/name.\"\n- \"Check the GitHub connection.\"\n- \"Publish [title] to the site.\"\n- \"[title] is live at [url].\""
    }
  ],
  "prompts": [
    {
      "text": "Connect GitHub for them.",
      "tool": "connect_github_for_client"
    },
    {
      "text": "Set the git publishing target to owner/name.",
      "tool": "set_cms_target"
    },
    {
      "text": "Check the GitHub connection.",
      "tool": "check_git_vercel_connection"
    },
    {
      "text": "Publish [title] to the site.",
      "tool": "publish_to_git_vercel"
    },
    {
      "text": "[title] is live at [url].",
      "tool": "mark_content_live"
    }
  ],
  "page": "https://nexus.effiqs.com/help/cms-git-vercel",
  "markdown": "https://nexus.effiqs.com/help/cms-git-vercel.md"
}