System Settings
Core system configuration including general settings, backend domain, PWA configuration, and operational controls
System Settings
System Settings is the central configuration hub for your CoAI.Dev platform. Configure core functionality, branding, operational controls, and platform features to customize your deployment according to your specific requirements.
Overview
System settings control fundamental platform behavior:
- 🏢 General Settings: Basic site configuration and branding
- 🌐 Backend Domain: API and service endpoint configuration
- 📱 PWA Configuration: Progressive Web App settings
- 💾 Storage Settings: File and image management
- ⚙️ Operational Controls: User registration and access management
Configuration Priority
System settings form the foundation of your platform. Configure these properly before setting up other features like billing, channels, or user management.
General Settings
Basic Site Configuration
Configure your platform's core identity and branding:
Website Information
- Site Name: The name displayed in browser tabs and throughout the platform
- Site Description: SEO description for search engines and social media
- Documentation Link: URL to your help center or documentation site
- Contact Information: Support email and contact details
Example Configuration:
Backend Domain Configuration
API Endpoint Setup
Critical for payment processing, image links, and API functionality:
Identify Deployment Architecture
Same Domain Deployment (Default):
- Frontend and backend on same domain
- Configuration:
https://yourdomain.com/api
- Common for single-server deployments
Separated Domain Deployment:
- Frontend and backend on different domains
- Configuration:
https://api.yourdomain.com
- Used for microservices or CDN optimization
Verify Configuration
Test backend connectivity:
- Payment webhook delivery
- Image URL generation
- API documentation access
- External service callbacks
Use Cases for Backend Domain
The backend domain is used in several critical scenarios:
- Payment Processing: Webhook URLs for payment confirmations
- Image Generation: Direct links to generated images (Midjourney, DALL-E)
- Email Templates: Links and assets in email communications
- API Documentation: Swagger/OpenAPI endpoint references
- File Downloads: Direct file access URLs
Security Consideration
Ensure your backend domain supports HTTPS and has proper SSL certificates configured for secure API communications.
PWA Configuration
Progressive Web App Setup
Transform your CoAI.Dev platform into a native-like mobile app:
Essential PWA Properties
- App Name: Name displayed when installed on devices
- Short Name: Abbreviated name for home screen
- App Icon: Icon used for installed app (512x512px recommended)
- Theme Color: Primary color for system UI elements
- Background Color: Color shown during app launch
Configuration Example:
For detailed PWA configuration, refer to the MDN Web App Manifest documentation.
Storage Settings
Image and File Management
Prerequisites
Image storage functionality requires the Backend Domain to be properly configured before enabling these features.
Image Storage Features
Problem Solving:
- Hotlink Protection: Some upstream services block direct image linking
- Image Expiration: External images may be deleted over time
- Reliability: Ensure images remain accessible to users
How It Works:
- System downloads images from external sources
- Stores them in local storage infrastructure
- Generates stable internal URLs
- Serves images directly from your domain
Configuration Options:
File Upload Settings
Supported File Types:
- Images: JPG, PNG, GIF, WebP
- Documents: PDF, DOC, DOCX, TXT
- Data: JSON, CSV, XML
Storage Backends:
- Local Storage: Files stored on server filesystem
- Amazon S3: Cloud storage with global CDN
- Google Cloud Storage: Google's cloud file storage
- Azure Blob Storage: Microsoft's cloud storage solution
Operational Controls
User Registration Management
Control access to your platform with registration settings:
Registration Settings
- Open Registration: Anyone can create accounts
- Closed Registration: No new account creation
- Invitation Only: Registration requires invitation codes
- Domain Restricted: Limit to specific email domains
Configuration Example:
Advanced Configuration
Environment-Specific Settings
Different configurations for various deployment environments:
Development Environment:
Production Environment:
Integration Settings
Configure external service integrations:
- Analytics Integration: Google Analytics, Mixpanel tracking
- Error Monitoring: Sentry, Bugsnag error tracking
- Performance Monitoring: New Relic, DataDog APM
- Support Integration: Intercom, Zendesk chat widgets
Security Considerations
Configuration Security
Protect sensitive configuration data:
- Environment Variables: Use for sensitive values
- Encryption: Encrypt sensitive configuration at rest
- Access Control: Limit who can modify system settings
- Audit Logging: Track all configuration changes
Validation and Testing
Ensure configuration correctness:
- Input Validation: Verify all configuration values
- Connectivity Testing: Test external service connections
- Staging Environment: Test changes before production
- Rollback Procedures: Plan for configuration rollbacks
Troubleshooting
Common Configuration Issues
Backend Domain Issues
Problem: Payment webhooks fail or images don't load
Solutions:
- Verify backend domain is accessible from external services
- Check SSL certificate validity and configuration
- Ensure proper DNS resolution for the domain
- Test webhook endpoints manually
- Verify firewall and security group settings
PWA Installation Problems
Installation Not Available:
- Verify HTTPS configuration
- Check web app manifest validity
- Ensure service worker is registered
- Confirm user engagement requirements
Images Not Displaying:
- Check image storage configuration
- Verify backend domain accessibility
- Review file permissions and storage access
- Test image URL generation manually
Proper system configuration is fundamental to platform success. Continue with Email & Notifications to set up communication features, or explore Analytics & Monitoring for tracking and insights.