Skip to main content

Frequently Asked Questions

Common questions and answers about SvelteBolt.

General Questions​

What is SvelteBolt?​

SvelteBolt is a modern SaaS starter kit built with SvelteKit, Supabase, and Stripe. It provides everything you need to build and deploy a subscription-based web application quickly.

What's included in SvelteBolt?​

  • Authentication - Complete user auth with Supabase
  • Database - PostgreSQL with Supabase
  • Payments - Stripe integration with subscriptions
  • UI Components - Modern, responsive design
  • Deployment - Ready for Vercel, Netlify, and Cloudflare Pages

Do I need coding experience?​

Basic knowledge of web development is helpful, but SvelteBolt includes comprehensive documentation to guide you through setup and customization.

Technical Questions​

Can I use a different database?​

SvelteBolt is built specifically for Supabase (PostgreSQL), but you can adapt it to work with other databases by modifying the database queries and authentication logic.

Can I use a different payment provider?​

The current version is built for Stripe, but you can integrate other payment providers by replacing the Stripe-specific code in the payment routes and components.

What Node.js version do I need?​

SvelteBolt requires Node.js 18 or higher. We recommend using the latest LTS version.

Can I deploy to other platforms?​

Yes! While we provide guides for Vercel, Netlify, and Cloudflare Pages, SvelteBolt can be deployed to any platform that supports Node.js applications.

Billing & Subscriptions​

How do trial periods work?​

Set PUBLIC_TRIAL_PERIOD_DAYS in your environment variables:

  • 14 = 14-day free trial
  • 0 = No trial period
  • Any number = Custom trial length

Can customers cancel subscriptions?​

Yes, customers can manage their subscriptions through the billing dashboard, which integrates with Stripe's customer portal.

What payment methods are supported?​

SvelteBolt supports all payment methods that Stripe supports, including credit cards, debit cards, and various local payment methods depending on your region.

Deployment Questions​

Why isn't my site loading after deployment?​

Common issues:

  1. Environment variables - Ensure all required variables are set
  2. Build errors - Check deployment logs for errors
  3. Domain configuration - Update Supabase and Stripe URLs

My webhooks aren't working​

  1. Verify your STRIPE_WEBHOOK_SECRET matches your Stripe webhook
  2. Ensure your webhook URL is correct: your-domain.com/api/stripe/webhook
  3. Check that your webhook is listening for the correct events

Database connection errors​

  1. Verify your Supabase credentials are correct
  2. Check that your Supabase project isn't paused
  3. Ensure your database schema is properly migrated

Getting Help​

Where can I get support?​

How do I report a bug or issue?​

  1. Check the troubleshooting guide first
  2. Search our Discord server to see if others had the same issue
  3. Email us at [email protected] with:
    • Detailed steps to reproduce the problem
    • Your environment details (OS, Node.js version, etc.)
    • Relevant error messages or logs

Can I request new features?​

Yes! Contact us at [email protected] and describe:

  • What you're trying to achieve
  • Why the current solution doesn't work
  • How you envision the feature working

Troubleshooting​

Common Error Messages​

"Invalid API key"

  • Check your Stripe/Supabase keys are correct
  • Verify you're using test keys in development
  • Ensure no extra spaces in your environment variables

"CORS error"

  • Add your domain to Supabase CORS settings
  • Verify your PUBLIC_SUPABASE_URL is correct

"Function invocation failed"

  • Check your serverless function logs
  • Verify environment variables are available
  • Ensure your code doesn't exceed timeout limits

Still need help?​

If you can't find the answer to your question:

  1. Search the documentation - Use the search function
  2. Check our Discord - See if others had the same problem
  3. Email support - Contact [email protected] with details
  4. Join the community - Connect with other SvelteBolt users on Discord