Deployment Guide

Deployment and configuration steps for GCC AppMart

Overview

GCC AppMart is built on the Base44 platform, which handles most deployment automatically. This guide covers the manual configuration steps needed for production deployment.

Auto-Deployment

Changes deploy automatically on save

Zero Infrastructure

No server management needed

Auto-Scaling

Scales based on traffic automatically

Built-in Auth

User authentication included

1. Environment Variables / Secrets

Configure these in your Base44 Dashboard → Settings → Environment Variables:

Required Secrets:

XAI_API_KEY
Required for AI
STRIPE_SECRET_KEY
Required for Payments
STRIPE_PUBLISHABLE_KEY
Required for Payments
STRIPE_WEBHOOK_SECRET
Required for Webhooks

Auto-Configured by Base44:

  • ✅ BASE44_APP_ID
  • ✅ Email service credentials
  • ✅ File storage credentials
2. Stripe Integration Setup

Step 1: Create Stripe Account

  1. Go to stripe.com
  2. Create account with business details
  3. Complete business verification

Step 2: Get API Keys

  1. Dashboard → Developers → API Keys
  2. Copy Publishable Key and Secret Key
  3. Add to Base44 environment variables

Step 3: Configure Webhook

  1. Dashboard → Developers → Webhooks
  2. Click "Add endpoint"
  3. Use URL: /functions/stripeWebhook
  4. Select events: payment_intent.succeeded, payment_intent.payment_failed, etc.
  5. Copy Webhook Secret
  6. Add to Base44 as STRIPE_WEBHOOK_SECRET

Test Mode

  • • Use Stripe test mode during development
  • • Test card: 4242 4242 4242 4242
  • • Any future date, any CVC
3. Grok AI Integration (xAI)

Step 1: Get API Key

  1. Go to x.ai
  2. Sign up / Login
  3. Navigate to API section
  4. Generate new API key

Step 2: Configure in Base44

  1. Add XAI_API_KEY to environment variables
  2. Test integration via AppGenius page

Features Using Grok:

  • ✓ AI Co-Pilot (AppGenius)
  • ✓ Smart Search
  • ✓ Content Generation
  • ✓ App Recommendations
4. Domain Configuration (Optional)

To use a custom domain (e.g., www.gccappmart.com):

In Base44 Dashboard:

  • Go to Settings → Domain
  • Add your custom domain
  • Note the CNAME/A record values

In Your Domain Registrar:

  • Add DNS records as instructed
  • Wait for DNS propagation (5-60 minutes)

SSL Certificate

Auto-provisioned by Base44 - No manual configuration needed

Security Checklist
All API keys stored as secrets
Stripe webhook signature verified
RLS enabled on all entities
Admin routes protected
File uploads validated
HTTPS enforced automatically
CORS configured properly
User authentication required
Go Live Checklist

Before announcing to users:

All environment variables configured
Stripe live mode enabled
Custom domain configured
All critical features tested
Admin accounts created
Sample apps uploaded
Email notifications tested
Payment processing tested
Mobile responsive verified
Arabic/English working
Terms & conditions reviewed
Privacy policy in place
Summary

Base44 Platform Handles:

Infrastructure management
Auto-scaling
Load balancing
Authentication
Database management
File storage
SSL/HTTPS
CDN

You Only Configure:

  • ✓ API keys for Stripe and Grok
  • ✓ Custom domain (optional)
  • ✓ Email templates (optional)

That's it! Your app is production-ready! 🚀