qianshuixia/shrimpreel

What is it?

Key features

• 01Cloudflare Workers, D1, R2, KV and Queues as the full backend stack
• 02Google sign-in, credit packs and monthly or yearly subscriptions
• 03Choice of Waffo Pancake, Dodo Payments or Stripe for payments, with refunds that claw back credits
• 04Generation queue with dead-letter handling and automatic credit return on failure
• 05Admin console for orders, users, generations, takedowns, redeem codes and referrals
• 06Bilingual English and Simplified Chinese pages with SSR, sitemap and JSON-LD

Use cases

• Launching a short-lived AI video site tied to a trending dance or filter keyword
• Starting a paid image-to-video SaaS on Cloudflare without building billing from scratch
• Running several keyword sites that share one codebase and receive upstream fixes via git merge

Quick start

1. 1

   Clone the template repository

   git clone https://github.com/qianshuixia/shrimpreel.git moonhop && cd moonhop
2. 2

   Install dependencies (npm 11.19 or newer)

   npm install
3. 3

   Copy .dev.vars.example to .dev.vars, set SESSION_SECRET, then apply migrations and seed local R2

   npm run seed:local
4. 4

   Start the dev server and open http://127.0.0.1:3000

   npm run dev -- --host 127.0.0.1

Things to know

• !Built around Cloudflare Workers, D1, R2, KV and Queues, so running it in production requires a Cloudflare account.
• !Production use needs real payment and video provider accounts; the default mock providers charge nothing and generate nothing new.
• !The README and docs are mainly in Chinese.

In collections

Topics

FAQ

What is shrimpreel?

Open-source Cloudflare-based template for building one-photo-to-AI-video SaaS sites, one site per trending keyword. ShrimpReel is a starter template for websites where a user uploads one photo and gets an AI-generated video that follows a viral template. The template is meant to be copied once per trending keyword: you create a new repository, change the site config, swap in your own copy and media, and deploy. The whole stack runs on Cloudflare Workers, D1, R2, KV, Queues, Rate Limiting and Cron Triggers, with TanStack Start and Hono on the application side.

Is shrimpreel free to use? What license does it have?

shrimpreel is open source under the MIT license. Check the license terms before using it in commercial products.

Is shrimpreel still maintained?

Actively maintained. The last commit to shrimpreel was on Nov 5, 2026.

What can I use shrimpreel for?

Launching a short-lived AI video site tied to a trending dance or filter keyword Starting a paid image-to-video SaaS on Cloudflare without building billing from scratch Running several keyword sites that share one codebase and receive upstream fixes via git merge

How do I install shrimpreel?

Clone the template repository: git clone https://github.com/qianshuixia/shrimpreel.git moonhop && cd moonhop Install dependencies (npm 11.19 or newer): npm install Copy .dev.vars.example to .dev.vars, set SESSION_SECRET, then apply migrations and seed local R2: npm run seed:local Start the dev server and open http://127.0.0.1:3000: npm run dev -- --host 127.0.0.1

Where can I get shrimpreel?

The source code and installation instructions are on GitHub: https://github.com/qianshuixia/shrimpreel