Frequently asked questions
Common questions about TanStarter, answered.
Questions we get asked a lot, with short answers.
What do I need to get started?
Git, Node.js 18+, and pnpm. Clone the repo, copy .env.example to .env, run pnpm install, then pnpm dev. The app starts at http://localhost:3000. See the Quick Start guide for details.
Can I deploy on Cloudflare's free plan?
Yes. The compiled template is about 2.3 MB, which is under the 3 MB limit on the Workers free tier. See the Deployment docs for more info.
How do I deploy to production?
Set your project name, custom domain, and D1/R2 bindings in wrangler.jsonc. Push secrets with pnpm wrangler secret bulk .env.production, then run pnpm run deploy. If you connect a GitHub repo, Cloudflare can deploy automatically on push. Full details in the Deployment guide.
Can I use something other than Stripe for payments?
Yes. The project already supports Stripe, Creem, and Waffo, and you can switch between them through the payment provider configuration. The payment module is built on a provider interface; to integrate another payment service, implement PaymentProvider and register the new provider. Email, newsletter, and notification modules follow the same pattern. See the Payment docs.
Does TanStarter support both subscriptions and one-time payments?
Both. Monthly/yearly subscriptions, lifetime one-time payments, and free trials all work. Users manage billing through the Stripe Customer Portal. WeChat Pay and Alipay are available if you enable them in Stripe's settings. Learn more in Stripe Payment docs.
How do I add a blog post?
Create a Markdown file in content/blog/ with frontmatter fields for title, description, date, category, and image. It shows up on the blog page automatically. See the Blog documentation.
Is there i18n support?
No, but TanStarter has a build-time language system via a messages module. English and Chinese are included. Switch the re-export in src/messages/index.ts to change languages.
How do I pull in template updates?
Add the template repo as a Git remote (git remote add upstream ...), fetch, and merge. After resolving conflicts, run pnpm install, apply any new migrations, and test. See the Updates guide.
Which analytics providers are supported?
Google Analytics, Umami, Plausible, and Microsoft Clarity. You can use any combination. Set the environment variables and they turn on in production automatically. See the Analytics docs.
Is TanStarter ready for production?
It's built for production use. Auth, payments, admin tools, SEO, analytics, email, and storage are all included and tested. People are already shipping real products with it; see the Showcase for examples. Check the Quick Start guide to get up and running.