Note: This documentation uses Next.js App Router. If you're still on Pages Router, see the migration guide.
🔧 Troubleshooting
📋 Table of Contents
🔍 Error Search
Copy Error Message
Paste your error message below to get useful links:
UI Interface Issues
Module Configuration Modal Won't Open
- Check if the module is properly selected (orange highlight)
- Refresh the page and try selecting the module again
- Ensure your browser allows popups from boiler.plate
Environment Variables Not Saving
- Make sure all required fields are filled before clicking "Save"
- Check for validation errors (red text) in the configuration modal
- Verify API keys are in the correct format (no extra spaces or quotes)
Project Generation Issues
"Create" Button Disabled
- Ensure project name is filled and valid (no special characters)
- Check that all selected modules show "configured" status
- Verify no conflicting modules are selected (e.g., db-sqlite + db-postgres)
Generation Failed or Incomplete
- Check the generation log in the UI for specific error messages
- Verify target directory has write permissions
- Ensure all environment variables are properly formatted
Integration-Specific Issues
Supabase Connection Failed
- Verify SUPABASE_URL and SUPABASE_ANON_KEY from your Supabase dashboard
- Check that the Supabase project is active and not paused
- Ensure SERVICE_ROLE_KEY has the correct permissions
Stripe Configuration Errors
- Use Price IDs (price_...) not Product IDs (prod_...) for subscriptions See Stripe Billing Module Configuration
- Ensure webhook endpoint is configured in Stripe dashboard See Stripe Billing Module Configuration
- Verify you're using the correct keys for your environment (test vs live) See Stripe Billing Module Configuration
- Check that your price is recurring for subscription mode See Stripe Billing Module Configuration
Getting Help
If you're still experiencing issues after trying these solutions:
- Check the generation logs in the UI for detailed error messages
- Take a screenshot of your module configuration
- Note which Quick Start Stack or modules you were using
- Contact support with the above information for faster resolution