API Configuration
Configure your Moorcheh AI integration for optimal chat performance.Environment Variables
Set your API key in the environment:API Configuration File
Createconfig/api-config.json with your settings:
Quick Setup via Console
The easiest way to configure your API settings:1
Visit Playground
2
Select Namespace
Choose your text namespace from the dropdown
3
Choose AI Model
Select your preferred AI model
4
Adjust Parameters
Configure temperature, top-k, and other parameters
5
Export Configuration
Click “Export” to download the complete configuration
6
Save Configuration
Copy the JSON content into
config/api-config.jsonBranding Configuration
Customize your application’s branding and appearance.Interactive Setup (Recommended)
Use the interactive setup flow for instant preview and configuration:Visit http://localhost:3000/landing to use our 4-step interactive setup flow.
Manual Configuration
Editconfig/appearance.json directly:
Branding Options Reference
| Field | Description | Example |
|---|---|---|
appName | Main app name shown in chat header | ”My AI Assistant” |
appTitle | Browser tab title | ”My Chat App” |
appSubtitle | Welcome message in chat | ”How can I help you today?” |
companyName | Your company/organization name | ”My Company” |
contactEmail | Support contact email | ”support@mycompany.com” |
logo | Logo image path | ”/assets/logo.png” |
Theme Configuration
Choose from 10+ beautiful themes to match your brand.Available Themes
Set your default theme in the configuration:Theme Options
The boilerplate includes these beautiful themes: Available themes:- Slate
- Gray
- Zinc
- Neutral
- Stone
- Red
- Orange
- Amber
- Yellow
- Lime
- Green
- Emerald
- Teal
- Cyan
- Sky
- Blue
- Indigo
- Violet
- Purple
- Fuchsia
- Pink
- Rose
Live Theme Preview
Test themes instantly using the interactive setup:Visit http://localhost:3000/landing → Step 3: Theme Selection to see live previews.
Font Configuration
Configure typography with 30+ Google Fonts and system fonts.Font Types
Configure three main font categories:Popular Font Combinations
Friendly & Readable
Friendly & Readable
- Primary: Inter
- Heading: Space Grotesk
- Mono: JetBrains Mono
Editorial & Trustworthy
Editorial & Trustworthy
- Primary: Lora
- Heading: Playfair Display
- Mono: Fira Code
Product & Dashboard
Product & Dashboard
- Primary: Inter
- Heading: Poppins
- Mono: JetBrains Mono
Live Font Preview
Test fonts with real-time updates:Visit http://localhost:3000/landing → Step 4: Typography to see live font previews.
Configuration via Console
Alternative method using Moorcheh Console Playground:1
Visit Console
2
Navigate to Appearance
Go to the Appearance section
3
Configure Settings
Set up your branding, themes, and fonts
4
Download Configuration
Click “Download” to export the complete configuration
5
Save File
Save the JSON file as
config/appearance.jsonConfiguration Validation
Ensure your configuration is valid and working:Check Configuration
Visit http://localhost:3000/demo to test your themes and fonts.Test Chat Interface
Your main chat interface at http://localhost:3000 will reflect your configuration.Troubleshooting
Common Configuration Issues
Configuration Not Loading
Configuration Not Loading
- Check file paths and JSON syntax
- Ensure files are in the correct directories
- Restart the development server
Themes Not Applying
Themes Not Applying
- Verify theme name spelling
- Check that theme files exist
- Clear browser cache
Fonts Not Loading
Fonts Not Loading
- Ensure font names are correct
- Check Google Fonts availability
- Verify font configuration syntax
Debug Steps
- Check browser console for errors
- Verify configuration files are properly formatted
- Test with default configuration first
- Use the interactive setup to validate settings
- Check that all required fields are present