ShipTanStarter DocsEnvironments
Configure environment variables for your ShipTanStarter application
ShipTanStarter requires several environment variables to function properly, and this guide explains how to set them up step by step.
Environment Variables
Website Configuration
| Variable | Description |
|---|---|
VITE_BASE_URL | The public URL of your site, e.g. http://localhost:3000 for development, https://your-domain.com for production |
Cloudflare
Learn how to obtain and configure the Token in the Cloudflare guide.
| Variable | Description |
|---|---|
CLOUDFLARE_ACCOUNT_ID | Cloudflare account ID (for Wrangler CLI and Cloudflare REST API) |
CLOUDFLARE_API_TOKEN | Cloudflare API token (for Wrangler CLI and Cloudflare REST API) |
Database
Learn how to set up a database in the Database Setup guide.
| Variable | Description |
|---|---|
CLOUDFLARE_DATABASE_ID | Cloudflare D1 database ID (for Drizzle Kit remote operations) |
Authentication
Learn how to set up authentication in the Authentication Setup guide.
| Variable | Description |
|---|---|
BETTER_AUTH_SECRET | A random string used to hash tokens and sign cookies |
GOOGLE_CLIENT_ID | Google OAuth client ID (optional) |
GOOGLE_CLIENT_SECRET | Google OAuth client secret (optional) |
Learn how to set up email in the Email Setup guide.
ShipTanStarter uses Cloudflare Email Service as the email provider.
| Variable | Description |
|---|---|
CLOUDFLARE_ACCOUNT_ID | Cloudflare account ID |
CLOUDFLARE_API_TOKEN | Cloudflare API token with Email Sending Write permission |
Storage
Learn how to set up storage in the Storage Setup guide.
ShipTanStarter uses Cloudflare R2 binding for storage, no additional environment variables are needed.
Payment
Learn how to set up payments in the Payment Setup guide.
Learn how to set up Stripe in the Stripe Setup guide.
| Variable | Description |
|---|---|
VITE_PAYMENT_PROVIDER | Set to stripe to enable Stripe as payment provider |
STRIPE_SECRET_KEY | Stripe secret key |
STRIPE_WEBHOOK_SECRET | Stripe webhook signing secret |
VITE_STRIPE_PRICE_PRO_MONTHLY | Stripe price ID for pro monthly subscription |
VITE_STRIPE_PRICE_PRO_YEARLY | Stripe price ID for pro yearly subscription |
VITE_STRIPE_PRICE_LIFETIME | Stripe price ID for lifetime one-time payment |
AI
Learn how to set up AI in the AI Setup guide.
| Variable | Description |
|---|---|
FAL_API_KEY | fal.ai API key for image generation, create one in fal.ai Dashboard |
Analytics
Learn how to set up analytics in the Analytics Setup guide.
| Variable | Description |
|---|---|
VITE_GOOGLE_ANALYTICS_ID | Google Analytics ID |
Chatbox
Learn how to set up chatbox in the Chatbox Setup guide.
| Variable | Description |
|---|---|
VITE_CRISP_WEBSITE_ID | Crisp Chat ID for website live chat |
Affiliates
Learn how to set up affiliates in the Affiliates Setup guide.
| Variable | Description |
|---|---|
VITE_AFFILIATE_AFFONSO_ID | Affonso affiliate marketing ID |
VITE_AFFILIATE_PROMOTEKIT_ID | PromoteKit affiliate marketing ID |
Verifying Environment Variables
To verify that your environment variables are correctly set up, run:
pnpm run devIf everything is configured correctly, your application should start and run normally without any environment-related errors.
Video Tutorials
Coming soon.
Next Steps
Now that your environment is set up, explore these related topics: