Skip to content

Configuration Guide โ€‹

How to connect your app to your website and customize basic settings.

๐Ÿ”— Connect to Your Website โ€‹

Step 1: Find Your Website URL โ€‹

Your website URL is the address people use to visit your online store. Examples:

  • https://mystore.com
  • https://shop.mycompany.com
  • https://mystore.botble.com

Step 2: Update App Configuration โ€‹

  1. Open the .env file in your app folder
  2. Find this line:
    API_BASE_URL=https://ecommerce-api.botble.com
  3. Replace it with your website:
    API_BASE_URL=https://your-website.com
  4. Save the file

Step 3: Test the Connection โ€‹

  1. Run your app:
    bash
    flutter run
  2. Try to login with an account from your website
  3. If it works, you're connected! ๐ŸŽ‰

โš™๏ธ Basic App Settings โ€‹

App Name โ€‹

Change your app's name by following: App Name Guide

App Colors โ€‹

Customize your app's colors: Theme Colors Guide

Add your logo: App Logo Guide

Languages โ€‹

Set up multiple languages: Translations Guide

๐Ÿ” Security Settings โ€‹

HTTPS Required โ€‹

  • Always use https:// in your website URL
  • Never use http:// for live websites
  • This keeps your customers' data safe

API Access โ€‹

Make sure your website allows the app to connect:

  1. Contact your website developer
  2. Tell them you need "API access enabled"
  3. They'll know what this means

๐Ÿงช Testing Your Setup โ€‹

Test These Features: โ€‹

  • โœ… Login with existing account
  • โœ… Browse products
  • โœ… Add items to cart
  • โœ… Search for products
  • โœ… View product details

If Something Doesn't Work: โ€‹

  1. Check your website URL is correct
  2. Make sure your website is online
  3. Try logging in on your website directly
  4. Contact support with details

๐Ÿš€ Advanced Configuration โ€‹

For more advanced setup:

๐Ÿ’ก Tips for Success โ€‹

Before Going Live: โ€‹

  • Test everything thoroughly
  • Try on different phones
  • Ask friends to test the app
  • Make sure payments work

Keep It Simple: โ€‹

  • Start with basic setup
  • Add features gradually
  • Test each change
  • Don't change too many things at once

๐Ÿ†˜ Common Problems โ€‹

"Connection Failed" โ€‹

  • Check your website URL
  • Make sure website is online
  • Contact your website developer

"Login Doesn't Work" โ€‹

  • Test login on your website first
  • Check if API is enabled
  • Verify user accounts exist

"No Products Show" โ€‹

  • Make sure products exist on website
  • Check if products are published
  • Verify categories are set up

For more help, check the Troubleshooting Guide.