When your site is built from a repository (Astro, Next.js, Hugo, Jekyll, Docusaurus, Gatsby and similar), the repository is the blog. Rank Prompt reads how its posts are written (the posts folder, the file name, the frontmatter keys, images, languages and the address a post goes live at) and writes each article the same way.
Publishing opens a pull request with the post as one more file. The article goes live when you merge it, and its link, the calendar and your article webhooks follow at that moment.
The repository connected in Integrations > Develop (the GitHub card)
Starter or higher on the brand owner, and the owner of the brand to set it up
Open Integrations > Develop. Under the connected repository, the Publishing row says Blog not read yet.
Click Read the blog. Rank Prompt reads the repository and shows Ready to publish with the framework and the posts folder, plus:
File: where a post is written, like src/content/blog/{locale}/{slug}.mdx
Goes live at: the address of a merged post, like {site}/blog/{slug}
Delivery: a pull request into your branch, or a direct commit
the frontmatter a post carries, how images are handled and the locales
Hover the ? next to the title to see the files it read and how sure it is.
Click Edit to correct anything. Read again later replaces what was read but keeps your corrections, the branch and how posts arrive.
A site address is needed to give a published post its link. If none was found, the row says Site address missing: add it with Edit.
When the site has no posts folder, the row says No blog found. For Astro, Next.js, Hugo and Jekyll, Add a blog opens a pull request that adds one following the repository's own layout. Articles publish here once it merges. For other frameworks, Edit lets you say where posts go.
Open an article, click Publish and pick the repository.
Publish now opens a pull request. The success window says Pull request opened with a Review PR button, and the publish window shows Waiting for merge until it merges.
Draft opens a draft pull request, to preview the post. Publishing the article later marks it ready.
Schedule opens nothing until the time comes.
Publishing again while the pull request is open adds a commit to it. Publishing a live post again opens a new pull request that updates the same file.
With Direct commit as the delivery, a live publish is committed to the branch and goes live with your next deploy, with nothing to merge.
A pull request closed without merging leaves the article as a draft. On the Articles list, an article waiting for its merge shows the Review pull request action, and the Calendar shows it as Waiting for merge.
A repository works as the destination of Content > Autopilot: each article waits in its pull request and counts as published once it merges. Links back from your related posts cannot be edited into the repository from here, so they come as tasks with the sentence to paste.
The agent can read the blog for you ("read my repo's blog") and open the pull request that adds one ("add a blog to my site"). Both need the brand owner.
Check that the Rank Prompt GitHub App still has access to the repository, then publish again.
Correct Goes live at or Site URL with Edit; the next publish uses it.
