shipwords

An open-source framework for new-keyword site fleets: a new site in an afternoon, taking payments the day it launches.

English · 中文

shipwords is a free, MIT-licensed framework for running a fleet of new-keyword AI image and video sites on Cloudflare, one site per keyword. What stays the same is shared: accounts, payments, credits and AI generation are written once. What changes is each site's own: pages, look and domain. Website: shipwords.dev.

Why shipwords

Built for a fleet of new-keyword sites. Put up a site for every new keyword, keep improving the ones that take off, and leave the rest alone. Fix a bug in the shared core once, and every site can take the update on its next deploy. Each site deploys on its own, with its own database, storage and payment account, so launching or retiring one never touches the others.

Proven AI, built in. tinydeskai.io is built on shipwords, and its full source is in sites/tinydeskai-example, ready to fork.

• Video templates: turn a viral clip into a template; visitors upload photos and get the same video back. That's how Tiny Desk AI works.
• Face swap that holds up: the whole clip in one pass. Each uploaded photo replaces a performer, face, hair and clothes, with mouths still on the beat. Missed swaps can be re-rendered shot by shot before delivery, as tinydeskai.io does.
• The popular models, built in: GPT Image, Nano Banana, Seedream, FLUX, Seedance, Veo, Kling, Wan and more, behind one Yir API key, paid per generation.

Takes money out of the box. Every site comes with:

• Google and email sign-in, account page
• Stripe and PayPal, credit packs and subscriptions, orders and refunds
• Email notifications
• Free guest tries with abuse limits (reCAPTCHA v3)
• Privacy, terms, refund and DMCA pages
• SEO, sitemap.xml, robots.txt, llms.txt, analytics

The money code is shared and tested: double charges, repeated or out-of-order payment events and refunds for failed jobs are all covered.

Build a site with your coding agent

No keyword yet? new-term-radar, a separate open-source project, catches new AI terms on X, Hugging Face, GitHub and sitemaps every day, before keyword tools list them.

Paste this into Claude Code, Codex or Cursor, with your own keyword:

Read shipwords.dev/llms.txt and build a site for "<your keyword>"

The agent clones the repo, creates the site and runs it locally. The rules it follows are in AGENTS.md.

Quick start

Requirements: Node 24 (see .nvmrc), pnpm 10 (corepack enable), and Git Bash or WSL on Windows. To go live you will also need a Cloudflare account and a Stripe or PayPal account.

1. Fork or clone this repo, then install:

   pnpm install
   

2. Create your first site from the template, then install again so the new site gets its dependencies:

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

3. Put local secrets outside the repo and link them in:

   mkdir -p ~/.config/shipwords
   cp sites/my-tool/.dev.vars.example ~/.config/shipwords/my-tool.dev.vars   # fill in test keys
   pnpm setup:worktree
   

   The example file runs as-is: email sign-in works (the code is printed in the dev server's terminal), new accounts get sign-up credits, and generations use the mock upstream (UPSTREAM_MOCK=1), so no model key is needed. Fill in more as you need it:

   • Real generations: a Yir API key, with UPSTREAM_MOCK turned off.
   • Buying credits: a Stripe test key (sk_test_…), then node ../../tools/stripe-listen.mjs in the site directory to forward webhooks.
   • Guest free tries: reCAPTCHA keys. Without them, visitors sign in before their first generation.
   • Google sign-in: a Google OAuth client with http://localhost:<port> as an origin. Optional; email sign-in works without it.

4. Run it:

   cd sites/my-tool
   pnpm db:generate && pnpm db:migrate:local
   pnpm dev
   

When you are ready to go live, follow docs/site-launch.md.

What it costs

The code is free under MIT, including commercial use. What you pay for:

• Domains (Cloudflare Registrar sells them at cost).
• Cloudflare usage. Sites that stitch video clips together use Cloudflare Containers and need the Workers Paid plan.
• Stripe or PayPal fees on each order.
• Model calls on Yir, billed per request. Each job's maximum cost is set in src/models.server.ts.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗