Skip to content

TipTok-App/Ribbit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ribbit: @RibbitBot_Bot

Ribbit is a creator monetisation platform built as a Telegram Mini App. Creators publish content — posts, media, documents, links — and fans pay to access it, all without leaving Telegram. There are no redirects, no new accounts, and no installs. Your Telegram account is your identity.

Telegram has over 1 billion monthly active users and more than 20 million public creator channels, yet almost none of the $254 billion creator economy flows through it. Existing monetisation platforms take 10–30% of earnings before card processing fees are added, leaving creators with as little as 55–70% of what fans actually pay. Ribbit charges around 5%, so creators keep approximately 95%.

Fans can pay using Telegram Stars — bought with Apple Pay, Google Pay, or any card — which convert instantly to Ribbit credits. Credits are used to unlock individual posts or subscribe to creator tiers. Crypto-native users can connect a TON wallet via TonConnect and pay directly on-chain through the x402 payment protocol. Creators withdraw their credits as real TON, sent on-chain to any wallet they choose.

Content is not limited to any format. Creators can post images, video, audio, PDFs, and links — including private Telegram group invites, Discord servers, or any URL. Ribbit also supports group unlocks: a creator sets a threshold (for example, 5 people) and the first supporters pay a small credit fee to unlock the content. Once the threshold is reached, the post becomes free for everyone. The creator earns, the content spreads.

Every creator who shares their Ribbit page is also introducing their existing audience to Telegram Mini Apps. This makes each creator an organic distribution channel for the broader TON ecosystem at no acquisition cost.

How It Works

The app is built on Next.js 15 with the App Router, running as a Telegram Mini App. Authentication is handled entirely through Telegram — every API request is validated server-side using HMAC-SHA256 of the Telegram initData payload, so no passwords or JWTs are needed.

Payments run on two parallel tracks. Non-crypto users buy Telegram Stars through the native Bot Payments API, which are converted to off-chain Ribbit credits stored in a Prisma database. These credits are spent on unlocks and subscriptions. Crypto users connect a TON wallet via TonConnect and pay directly on-chain using the x402 HTTP 402 payment protocol. When a creator withdraws, the platform treasury wallet sends real TON to their address — the transaction is broadcast via the TON RPC and is verifiable on TonScan.

File uploads are handled through UploadThing. Content access is enforced server-side on every request — the API checks subscription status and per-post unlock records before returning any content URL.

About

Find @RibbitBot_Bot on telegram to try it out!

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages