Repolode
shipwords-dev

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. 1

    Fork or clone the repo, then install dependencies (needs Node 24 and pnpm 10)

    pnpm install
  2. 2

    Create your first site from the template

    pnpm new-site my-tool --domain my-tool.com
  3. 3

    Install again so the new site gets its dependencies

    pnpm install
  4. 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