LogoTanStarter Docs
LogoTanStarter Docs
HomepageIntroductionCodebaseGetting StartedEnvironments
Configuration
Deployment

Integrations

CloudflareDatabaseAuthenticationEmailNewsletterStoragePaymentNotificationsAnalyticsChatboxAffiliates

Customization

MetadataPagesLanding PageBlogComponentsUser ManagementAPI Key Management

Codebase

Project StructureFormatting & LintingEditor SetupUpdating the Codebase
X (Twitter)

Environments

Configure environment variables for your TanStarter application

TanStarter requires several environment variables to function properly, and this guide explains how to set them up.

Environment Variables

Website Configuration

VariableDescription
VITE_BASE_URLThe public URL of your site, e.g.
http://localhost:3000 for development,
https://your-domain.com for production

Cloudflare API Token

Learn how to obtain and configure the Token in the Cloudflare API Token guide.

VariableDescription
CLOUDFLARE_ACCOUNT_IDCloudflare account ID (for Wrangler CLI and Drizzle Kit remote operations)
CLOUDFLARE_API_TOKENCloudflare API token (for Wrangler CLI and Drizzle Kit remote operations)

Database

Learn how to set up a database in the Database Setup guide.

VariableDescription
CLOUDFLARE_DATABASE_IDCloudflare D1 database ID (for Drizzle Kit remote operations)

Authentication

Learn how to set up authentication in the Authentication Setup guide.

VariableDescription
BETTER_AUTH_SECRETA random string used to hash tokens and sign cookies
GOOGLE_CLIENT_IDGoogle OAuth client ID (optional)
GOOGLE_CLIENT_SECRETGoogle OAuth client secret (optional)

Email

Learn how to set up email in the Email Setup guide.

VariableDescription
RESEND_API_KEYAPI key for Resend email service

Newsletter

Learn how to set up newsletter in the Newsletter Setup guide.

VariableDescription
RESEND_API_KEYAPI key for Resend email service

Storage

Learn how to set up storage in the Storage Setup guide.

TanStarter uses Cloudflare R2 binding for storage, no additional environment variables are needed.

Payment

Learn how to set up payments in the Payment Setup guide.

VariableDescription
STRIPE_SECRET_KEYStripe secret key
STRIPE_WEBHOOK_SECRETStripe webhook signing secret
VITE_STRIPE_PRICE_PRO_MONTHLYStripe price ID for pro monthly subscription
VITE_STRIPE_PRICE_PRO_YEARLYStripe price ID for pro yearly subscription
VITE_STRIPE_PRICE_LIFETIMEStripe price ID for lifetime one-time payment

Notification

Learn how to set up notification in the Notification Setup guide.

VariableDescription
DISCORD_WEBHOOK_URLDiscord webhook URL for receiving notifications
FEISHU_WEBHOOK_URLFeishu webhook URL for receiving notifications

Analytics

Learn how to set up analytics in the Analytics Setup guide.

VariableDescription
VITE_GOOGLE_ANALYTICS_IDGoogle Analytics ID
VITE_UMAMI_WEBSITE_IDUmami Analytics website ID
VITE_UMAMI_SCRIPTUmami Analytics script URL
VITE_PLAUSIBLE_SCRIPTPlausible Analytics script URL
VITE_CLARITY_PROJECT_IDClarity project ID

Chatbox

Learn how to set up chatbox in the Chatbox Setup guide.

VariableDescription
VITE_CRISP_WEBSITE_IDCrisp Chat ID for website live chat

Affiliates

Learn how to set up affiliates in the Affiliates Setup guide.

VariableDescription
VITE_AFFILIATE_AFFONSO_IDAffonso affiliate marketing ID
VITE_AFFILIATE_PROMOTEKIT_IDPromotekit affiliate marketing ID

Verifying Environment Variables

To verify that your environment variables are correctly set up, run:

pnpm dev

If everything is configured correctly, your application should start and run normally without any environment-related errors.

Next Steps

Now that your environment is set up, explore these related topics:

Website Configuration

Configure website settings

Getting Started

TanStarter template getting started guide

Database

Configure database

Deployment

Deploy to Cloudflare Workers

Table of Contents

Environment Variables
Website Configuration
Cloudflare API Token
Database
Authentication
Email
Newsletter
Storage
Payment
Notification
Analytics
Chatbox
Affiliates
Verifying Environment Variables
Next Steps