CLI

TanStarter CLI automates the full TanStarter setup and deployment flow. With one guided command, you can create a new project from the TanStarter template, prepare Cloudflare resources, configure environment files, deploy to Cloudflare Workers, and push the initialized code to GitHub.

If you already understand the manual steps in Getting Started, Cloudflare Configuration, and Deployment, the CLI is the fastest path. It turns those steps into a guided workflow that can deploy a new TanStarter project in about 5 minutes.

What It Does

The CLI runs the same work you would normally do by hand when launching a TanStarter project:

1. Clones the TanStarter template.
2. Installs dependencies with pnpm install.
3. Checks local tools and Cloudflare credentials.
4. Creates Cloudflare D1, R2, and KV resources.
5. Updates wrangler.jsonc with your Worker, D1, R2, KV, and route settings.
6. Writes .env and .env.production.
7. Runs database migrations.
8. Builds and deploys to Cloudflare Worker.
9. Syncs runtime Worker secrets.
10. Creates a private GitHub repository.
11. Syncs GitHub Actions secrets.
12. Commits and pushes the initialized project to main.

This makes the CLI useful when you want a production-ready starting point quickly, or want a repeatable setup flow for multiple TanStarter projects.

Prerequisites

The CLI checks for node, pnpm, git, gh, GitHub CLI authentication, and Cloudflare credentials before it starts creating resources. If pnpm, git, or gh is missing, it attempts to install the missing tool with the available system package manager.

Quick Deploy

Run the CLI directly with npx:

npx tanstarter-cli@latest create

TanStarter CLI will ask for the project name, GitHub repository, Cloudflare resource names, and optional domain settings before creating anything.

After the workflow completes, you will have:

• A deployed Cloudflare Workers website.
• A private GitHub repository with the TanStarter template.
• Cloudflare D1, R2, and KV resources connected to the project.
• Worker runtime secrets synced to Cloudflare.
• GitHub Actions secrets synced for future automated deployments.

Install Globally

You can also install the CLI globally if you plan to use it often:

npm install -g tanstarter-cli

Then run:

tanstarter create

The global command supports the same options as the npx command.

Command Reference

tanstarter create [options]
tanstarter create <project-name> --resume
tanstarter delete <project-name> [options]

Resume a Failed Setup

If the setup fails after the project directory has been created, fix the reported issue and resume the workflow:

tanstarter create your-project-name --resume

The CLI stores setup progress in .tanstarter/state.json, so it can continue from the completed steps instead of starting over.

Delete Created Resources

To remove Cloudflare and GitHub resources created by the CLI, run:

tanstarter delete your-project-name

Video Tutorial

Next Steps

After deploying with the CLI, continue with the parts of the template you want to customize: