CoAI LogoCoAI.Dev
Configuration

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:

{
  "site_name": "ChatNio AI Platform",
  "site_description": "Advanced AI service management platform for businesses",
  "documentation_url": "https://docs.chatnio.com",
  "support_email": "support@chatnio.com"
}

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

Configure Backend URL

For Same Domain Setup:

Backend Domain: https://yourdomain.com/api

For Separated Domains:

Backend Domain: https://api.yourdomain.com

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:

{
  "name": "ChatNio AI Assistant",
  "short_name": "ChatNio",
  "theme_color": "#2563eb", 
  "background_color": "#ffffff",
  "display": "standalone",
  "orientation": "portrait"
}

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:

  1. System downloads images from external sources
  2. Stores them in local storage infrastructure
  3. Generates stable internal URLs
  4. Serves images directly from your domain

Configuration Options:

{
  "image_storage": {
    "enabled": true,
    "storage_type": "local", // or "s3", "cloudinary"
    "max_file_size": "10MB",
    "allowed_formats": ["jpg", "png", "gif", "webp"],
    "cdn_enabled": true,
    "compression": {
      "enabled": true,
      "quality": 85
    }
  }
}

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:

{
  "registration": {
    "enabled": true,
    "require_email_verification": true,
    "allowed_domains": ["company.com", "partners.com"],
    "require_approval": false,
    "invitation_only": false
  }
}

Advanced Configuration

Environment-Specific Settings

Different configurations for various deployment environments:

Development Environment:

{
  "debug_mode": true,
  "detailed_errors": true,
  "cors_origins": ["http://localhost:3000"],
  "rate_limiting": false
}

Production Environment:

{
  "debug_mode": false,
  "detailed_errors": false,
  "cors_origins": ["https://yourdomain.com"],
  "rate_limiting": true,
  "security_headers": true
}

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:

  1. Verify backend domain is accessible from external services
  2. Check SSL certificate validity and configuration
  3. Ensure proper DNS resolution for the domain
  4. Test webhook endpoints manually
  5. 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.