Documentation menu

Founders and technical teams | Updated 2026-11-17

Build in public from GitHub, one destination per repo

Connect GitHub, then choose for each repo which accounts or collection its posts go to, how often it posts, and whether you approve first.

What each repo does

When you merge a pull request, publish a release or push a tag, the repo writes a draft in your voice. It reads your recent posts and matches how you write.

Every repo has its own settings, so a client project, a product and a side project can each post to different accounts.

Set up a repo

Setup takes three steps: connect GitHub, pick your repos, choose where each posts.

  1. Open Dashboard, then Build in Public, and connect GitHub.
  2. Add the repos you want. Each one appears as a card.
  3. On a repo card, press Choose where it posts. Pick accounts, or pick a collection to post to every account in it.
  4. Pick how often: every change, a daily summary or a weekly summary. A new repo starts on a weekly summary.
  5. Pick whether you approve each draft or let it post at the best time. A new repo starts on approval.
  6. Choose what counts: merged PRs, releases, tags or direct pushes. Bots and chores are skipped by default.
  7. Press Write a sample to see a post before anything reaches your queue.

Voice and links

Add a short voice note per repo, for example short, dry, first person. Add a link and it is shortened and click-tracked, with the repo name as the campaign.

Use it from an assistant

build_in_public_status shows each repo with its destination, schedule, latest draft and the accounts and collections available. Pass targets true for the list, or previewRepo to write a sample.

build_in_public_configure takes a repo plus routeTo (accounts, collection or none), accountIds or collectionId, cadence, approval, sources, ignoreBots, ignoreChores, voice and linkUrl. Setting approval to AUTO needs a publish-capable token.

What to approve

Approve posts about something a user can see or do. Reject dependency bumps and internal notes unless they teach your audience something.

Related guides and tools