Builder guide — Raws.dev docs

Enable the program

Every project on Raws.dev has a built-in ambassador hub at /p/<slug>/ambassadors. The hub is empty by default — open it once as the owner to access setup. There's nothing to "install" — it's part of the project.

Inviting ambassadors

Three ways to onboard ambassadors:

By handle. Enter a Raws.dev user's @handle. They get a notification and can accept or decline from /my/ambassadors.
By email. For people who aren't on Raws.dev yet — they get a Postmark mail with a tokenised claim link. When they sign in via that link, they're auto-added as an active ambassador.
Public invite link. Toggle "Open — accepting applications" and share /p/<slug>/become-ambassador. Applicants land in a pending queue you review before granting access.

Reviewing applications

When the public link is open, applications appear in the hub under "Pending applications". Each row shows the applicant's profile, bio, location. Approve grants them active status and triggers the welcome tour on their next visit. Reject sets the row to declined — they can't re-apply silently (you'll see a duplicate request).

Tip commissions (0 / 30 / 50 / 80%)

Pay your ambassadors a slice of every tip received via their referral link. Pick a tier from the hub:

Tier	Use it when
0%	Default. Ambassadors get leaderboard credit but no revenue share.
30% — Light	Casual amplification, low-effort sharing.
50% — Even split	You and the ambassador each take half. Strong incentive for active push.
80% — Aggressive	For projects where the ambassador's audience IS the entire funnel. Common for content creators.

Only tips received via an ambassador's referral link are split — direct tips stay 100% yours. Settled instantly via Stripe Connect transfer when the tip succeeds. If the ambassador hasn't onboarded Connect, the row stays pending and settles automatically once they do.

Per-signup payouts

Pay each ambassador a fixed amount when one of their referrals signs up on your external SaaS — not just on Raws.dev. Set a $ amount per signup (presets $5/$10/$25/$50/$100, custom OK), embed our tracking tag, and the ambassador is paid via Stripe Connect every time you fire a conversion.

Full installation walk-through: Integration guide →

Public accountability: the project's public ambassador board displays your conversion rate (visits → reported conversions, last 30d) and "last paid signup" age. If the system tracks ≥100 ambassador-driven visits but zero reported conversions, a red warning flags the project — visible to ambassadors before they apply.

Wallet

Per-signup payouts are funded by a prepaid wallet on your account. Top up via Stripe Checkout from /my/ambassadors (presets $50–$1,000). Each conversion debits the wallet at the project's per-signup rate, then transfers immediately to the ambassador's Stripe Connect account.

If the wallet runs dry mid-fire, the conversion is queued as unfunded. You'll see a counter in the wallet widget. Top up — queued rows release FIFO immediately on success.

Where do referral links land?

By default, ambassador links (raws.dev/r/<slug>/<handle>) redirect to your project page on Raws.dev. Set Where do referral links land? in the hub to redirect straight to your SaaS — utm_source, utm_medium and utm_campaign={handle} are appended automatically so the traffic shows up in your own analytics. The ambassador still gets credit either way (cookie + tracked pageview).

Missions

Specific tasks ambassadors can claim, complete, and submit for validation. Create them in the Missions tab of the hub: a title, optional description, optional deadline, optional platform target (X, LinkedIn, etc.).

Lifecycle: ambassador claims → submits proof URL after publishing → owner approves or rejects (with optional reason). Approved missions count toward Bronze/Silver/Gold tier promotion.

Share templates

Pre-written posts your ambassadors can fire with one click. Add them in the Templates tab — pick a platform (X, LinkedIn, Reddit, Hacker News, Bluesky, Mastodon, blog), give a label, write the body. Use {referral_url} as a placeholder; it gets substituted with the ambassador's personal short link.

Ambassadors see them with the right share-intent button per platform — "Post on X" opens the X composer pre-filled, etc. Mastodon and other platforms with no public intent URL fall back to "Copy text".

Media kit

Drop banner images, brand colours (hex), useful links (docs, demo, deck) and copy snippets in the Media tab. Ambassadors see them all on their hub side, ready to grab.

Moderation

Revoke — remove an active ambassador from the program. They lose access to the hub, the group chat and stop driving credit.
Ban — revoke + block from re-applying. Use for abuse.
Reverse a payout — within 7 days of a per-signup fire, dispute the conversion. Stripe transfer is reversed and the wallet is credited back.