ship & shout
Help center

Questions makers actually ask.

Everything about connecting your sources, keeping drafts honest, publishing, billing, and your data. Can't find it? Support and Contact are below.

Getting started

What Ship & Shout is, who it's for, and how fast you're up and running.

What does Ship & Shout do?
Every week it reads your connected data — GitHub activity, revenue, and traffic — and drafts an honest, numbers-first build-in-public post plus a revenue chart. You review, tweak, and publish. Ship all week; shout in one click.
Who is it for?
Indie makers, solo founders, and small teams building in public who want to post consistently without spending an hour each week staring at a blank editor. If you ship code and want the story told from real metrics, it's for you.
How long does setup take?
About 60 seconds. Sign in with GitHub, connect the sources you want (code, revenue, analytics), pick a delivery day, and you're done. Your first draft arrives on your next scheduled run.
Do I need the X/Twitter API?
No. There's no X/Twitter API in v1 and nothing to apply for. You publish to X by copying the finished post to your clipboard and pasting it. LinkedIn gets one-click publishing on Pro; everything else is copy, paste, or download.
What happens on a quiet week when I didn't ship much?
You still get an honest draft. Ship & Shout writes to the metrics you actually have — a documentation pass, a small fix, flat revenue — rather than inventing momentum. A calm, truthful update beats a fabricated highlight reel.
Do I need to be technical to use it?
No. If you can click "Connect GitHub" you can use Ship & Shout. The drafts are written in plain language, and you can edit every word before anything goes out. Stuck? Support and Contact are one click away.

Connecting sources

Code hosts, payment providers, and analytics — all read-only.

Which code hosts can I connect?
GitHub, GitLab, and Bitbucket. Ship & Shout reads commit metadata and merged pull requests — counts, titles, timestamps — to summarise what shipped. It never reads your file contents or source code.
What does it pull from my code host, exactly?
Just the shape of your week: how many commits landed, which pull requests merged, and when. That metadata becomes the "what shipped" line in your post. Diffs, file trees, and code bodies are never fetched.
Which payment providers work?
Stripe and Lemon Squeezy. Ship & Shout reads revenue totals plus new and churned customers for the week so your post can cite real numbers. It has read-only access and never moves, refunds, or charges money.
Which analytics providers work?
Plausible, Vercel Analytics, and Fathom. It reads visitor counts for the week so traffic can appear alongside revenue and shipping in your draft.
What OAuth scopes do you request?
Read-only scopes, everywhere, by design. Ship & Shout never writes to GitHub or your payment providers. The one thing it writes on your behalf is a LinkedIn post you explicitly publish. More detail on Security.
Can I connect more than one source of the same type?
Yes. Connect multiple repos and multiple providers — say GitHub for code and both Stripe and Lemon Squeezy for revenue — and the week's metrics are merged into one narrative.
How do I revoke or disconnect a source?
Open Settings → Connections and disconnect any source in one click; you can also revoke access from the provider's own app settings. Disconnecting stops all future reads immediately.

Drafts & voice

How drafting works, and why the numbers are always real.

How does drafting actually work?
Your week's metrics are turned into a single LLM call that returns a finished post in your voice. One call per draft, structured output — no chains of agents, no scraping the web, no filler.
Will it invent numbers?
No. Every number in a draft comes from your connected metrics. An automated eval verifies that on 20 fixtures before we ship changes, the drafter refuses hype words, and it always mentions churn when customers churned. Honesty is the product.
How does it learn my voice?
You give it a little tone training — a few examples of how you write — and it drafts to match. You stay in control per post with tone chips.
What are tone chips?
Quick toggles that steer a draft's feel: Concise, Numbers first, No hype, Warm, Technical, and Playful. Flip a chip and regenerate to nudge the voice without rewriting from scratch.
Can I edit the draft before publishing?
Always. Every draft opens in an editor — change a word, a number's framing, or the whole thing. Nothing is published until you say so.
How many times can I regenerate a draft?
Free includes one weekly draft. Pro raises the ceiling to up to five regenerations a week so you can try different tones and lengths. See Pricing for the exact limits.
Why does it refuse hype words?
Build-in-public readers reward candour and tune out "crushing it" energy. The drafter is tuned to avoid empty superlatives and to state what the metrics say plainly — including the down weeks and any churn.

Publishing

Where your finished post can go.

How do I publish to X/Twitter?
Copy the finished post to your clipboard and paste it into X. No API, no app to authorise — you keep full control of what's posted and when.
How does LinkedIn publishing work?
On Pro, publish to LinkedIn in one click. It's always user-initiated — nothing posts on a schedule or without you pressing publish. This is the only place Ship & Shout writes on your behalf.
Can I download the chart on its own?
Yes. Download the revenue chart as a PNG and attach it wherever you like — a thread, a newsletter, a Discord post.
What is the public timeline?
An opt-in page that collects your published posts into a running build-in-public timeline others can follow. It's off unless you turn it on, and it carries a small "Ship & Shout" badge.
Is there a watermark on the free plan?
Free drafts and charts carry a small Ship & Shout badge. Pro removes the watermark from charts and drops the badge. Details on Pricing.

Charts

The revenue chart that ships with every post.

What chart themes are available?
Three, tuned for where you post: Ink for X's dark timeline, Paper for LinkedIn and light backgrounds, and Terminal for a developer look.
What size are the charts?
1200×675 pixels — a clean 16:9 that fits social cards and link previews without awkward cropping.
Can I use my own colours?
Custom chart themes are a Pro feature, so your charts match your brand instead of the three defaults. See Pricing.
How do I remove the watermark from a chart?
Upgrade to Pro. Free charts carry the badge; Pro renders them clean.
What data does the chart show?
Your revenue trend for the period, drawn from the same connected payment data as the post — so the picture and the words always agree.

Billing & plans

Free, Pro, and the launch Lifetime deal.

What plans are there?
Three: Free ($0), Pro ($15/mo or $150/yr), and a launch Lifetime deal ($225 once). Full breakdown on Pricing.
What's included in Free?
One weekly draft, the revenue chart, and copy-to-clipboard publishing — with a small Ship & Shout badge on drafts and charts. Plenty to post consistently.
What do I get with Pro?
Watermark removal, up to five regenerations a week, custom chart themes, and one-click LinkedIn publishing — $15/mo, or $150/yr which is two months free.
What is the Lifetime deal?
A one-time $225 payment for Pro features for the life of the product — a launch offer for early supporters. No recurring bill.
Do you offer refunds?
Yes — a 30-day refund on Pro. If it isn't for you within the first month, ask via Support and we'll sort it out.
Can I cancel anytime?
Anytime. Cancel from your billing settings and you keep Pro through the end of the period you've paid for, then drop to Free. No lock-in.
Who handles billing and VAT?
Lemon Squeezy is our merchant of record. They process payments and handle VAT and sales tax for you, so your receipts and tax are taken care of at checkout.

Security & privacy

Read-only by design, encrypted at rest.

How do you keep my accounts safe?
Read-only by design. Ship & Shout only ever reads metadata and metrics — it can't push code, move money, or change your accounts. The single write action is a LinkedIn post you trigger yourself.
How are my tokens stored?
Every third-party token is encrypted at rest with AES-256-GCM and only decrypted server-side when a job needs it. Tokens are never logged and never sent to your browser.
Who can see my data?
Only you. Every database table enforces Row-Level Security, so your rows are scoped to your account and can't be read across users.
Where does my data live?
In Supabase (Postgres, storage) and Vercel (hosting), both reputable managed platforms. More in the Security overview.
Where can I read the full policies?
See Security, the Privacy Policy, and GDPR & Your Data for the complete picture on how information is handled and your rights.

Account & data

Export, delete, and reactivate — your data is yours.

Can I export my data?
Yes. You can export your drafts and account data for portability, so nothing is trapped inside Ship & Shout. See GDPR & Your Data for the details.
How do I delete my account?
Settings → Account → Delete. On deletion your connection tokens are revoked immediately, any public timeline goes offline within the hour, and backups are purged within 30 days.
What exactly gets removed when I delete?
Your account, connection tokens, drafts, and charts. Tokens are revoked at once; live surfaces like the timeline come down within the hour; residual copies in backups are purged within 30 days.
Can I come back after deleting?
You can sign up again anytime, but deletion is permanent — a new account starts fresh, since your previous data has been purged. There's no undo once backups clear.
What are my rights under GDPR?
Access, portability, correction, and erasure — all supported. The GDPR & Your Data page explains each right and how to exercise it.

Troubleshooting

Quick fixes for the most common snags.

My draft didn't arrive — what now?
Check three things: your delivery day and timezone in settings (the job runs on your schedule), your spam folder, and your connection status in Settings → Connections. If a source dropped, no metrics means no draft. Still stuck? Support can help.
A connection failed or shows disconnected.
Re-authorise it in Settings → Connections. Tokens can expire or be revoked at the provider; reconnecting issues a fresh read-only grant and gets the next draft flowing again.
The numbers in my post look wrong.
Every number is pulled straight from your connected sources for the week's window, so a mismatch usually means a source is disconnected, a repo or account isn't linked, or the period differs from where you're comparing. Check Connections; if it still looks off, Contact us with the details.
I never got the notification email.
Our email is sent via Resend from hello@shipandshout.co. Check your spam folder and add that address to your contacts. If it's still missing, reach out through Support.
The chart isn't rendering.
A chart needs revenue data for the week — if your payment provider is disconnected or returned nothing, there's nothing to plot. Reconnect in Settings → Connections and regenerate. Persisting? Contact us.
Something else is broken.
Head to Support for guides or Contact to reach a human. Include your delivery day and which source is involved so we can help faster.

Didn't find your answer?

Browse the guides or reach a human — we're happy to help you get your first honest post out the door.

Visit SupportContact us