Open-source SaaS starter built on React, TypeScript, Firebase and Stripe, covering auth, billing, teams and i18n.
shipwords-dev/shipwords
An open-source Cloudflare-native framework for running a fleet of new-keyword AI sites, with shared auth, credits, payments and AI generation.
- Stars
- 358
- Forks
- 231
- Open issues
- 0
- Last commit
- 4 days ago
What is it?
shipwords is a TypeScript framework for launching many small AI image and video sites, one per keyword, on Cloudflare Workers. Accounts, Stripe and PayPal billing, credit ledger, and AI generation live in a shared core that every site uses, while each site keeps its own pages, look, domain, database, storage and payment account, so launching or retiring one site does not affect the others.
The project includes a complete AI image site template, a scaffolding command (`pnpm new-site`) and launch checks. Generation jobs run on Cloudflare Workflows with automatic refunds for failed jobs. Sites include SEO files such as sitemap.xml, robots.txt and llms.txt, plus privacy, terms, refund and DMCA pages. A full video-effect site, tinydeskai-example, is included as reference source.
The stack is TanStack Start, React 19, D1, Drizzle, R2 and Workflows, released under MIT. Model calls go through the Yir API, with a mock upstream for local development.
Key features
- 01Scaffolds new keyword sites from a template with `pnpm new-site`.
- 02Shared accounts, Stripe and PayPal billing, and a credit ledger with idempotent writes.
- 03Generation jobs run on Cloudflare Workflows with automatic refunds for failed jobs.
- 04Built-in SEO files including sitemap.xml, robots.txt and llms.txt.
- 05Mock upstream for local development without a model API key.
Use cases
- Launching many small AI tool sites for different keywords on one codebase.
- Starting a paid AI image or video generation site with accounts and credits already wired up.
- Studying a complete example of a Cloudflare Workers SaaS built with TanStack Start.
Quick start
- 1
Fork or clone the repo, then install dependencies (needs Node 24 and pnpm 10)
pnpm install - 2
Create your first site from the template
pnpm new-site my-tool --domain my-tool.com - 3
Install again so the new site gets its dependencies
pnpm install - 4
In sites/my-tool, set up the local database and start the dev server
pnpm dev
Things to know
- Going live requires a Cloudflare account and a Stripe or PayPal account.
- Video sites that stitch clips need the Cloudflare Workers Paid plan.
- Real AI generations need a paid Yir API key; the default setup uses a mock upstream.
In collections
Topics
FAQ
- What is shipwords?
- An open-source Cloudflare-native framework for running a fleet of new-keyword AI sites, with shared auth, credits, payments and AI generation. shipwords is a TypeScript framework for launching many small AI image and video sites, one per keyword, on Cloudflare Workers. Accounts, Stripe and PayPal billing, credit ledger, and AI generation live in a shared core that every site uses, while each site keeps its own pages, look, domain, database, storage and payment account, so launching or retiring one site does not affect the others.
- Is shipwords free to use? What license does it have?
- shipwords is open source under the MIT license. Check the license terms before using it in commercial products.
- Is shipwords still maintained?
- Actively maintained. The last commit to shipwords was on Nov 3, 2026.
- What can I use shipwords for?
- Launching many small AI tool sites for different keywords on one codebase. Starting a paid AI image or video generation site with accounts and credits already wired up. Studying a complete example of a Cloudflare Workers SaaS built with TanStack Start.
- How do I install shipwords?
- Fork or clone the repo, then install dependencies (needs Node 24 and pnpm 10): pnpm install Create your first site from the template: pnpm new-site my-tool --domain my-tool.com Install again so the new site gets its dependencies: pnpm install In sites/my-tool, set up the local database and start the dev server: pnpm dev
- Where can I get shipwords?
- The source code and installation instructions are on GitHub: https://github.com/shipwords-dev/shipwords
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted, revenue-first web analytics that shows which traffic source actually produced paying customers, running on Cloudflare's free plan.
A personal AI assistant that runs entirely inside your own Cloudflare account, with chat, memory, tasks, notes and scheduled reminders.
A bookmark manager built on Cloudflare Workers and D1 that saves links via a bookmarklet or Chrome extension, with no account required.
An AI-driven project that scrapes daily Hacker News top stories, summarizes them in Chinese, and turns them into a podcast with RSS feed.
Open-source visual website builder that connects to headless CMSs and can be self-hosted, positioned as a Webflow alternative.