Skip to main content

API Configuration

Configure your Moorcheh AI integration for optimal chat performance.

Environment Variables

Set your API key in the environment:

API Configuration File

Create config/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.json

Branding Configuration

Customize your application’s branding and appearance. 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

Edit config/appearance.json directly:

Branding Options Reference

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:
  • Primary: Inter
  • Heading: Space Grotesk
  • Mono: JetBrains Mono
  • Primary: Lora
  • Heading: Playfair Display
  • Mono: Fira Code
  • 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.json
The console playground provides the same configuration options as the interactive setup, with the added benefit of being able to download the complete configuration file.

Configuration 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

  • Check file paths and JSON syntax
  • Ensure files are in the correct directories
  • Restart the development server
  • Verify theme name spelling
  • Check that theme files exist
  • Clear browser cache
  • Ensure font names are correct
  • Check Google Fonts availability
  • Verify font configuration syntax

Debug Steps

  1. Check browser console for errors
  2. Verify configuration files are properly formatted
  3. Test with default configuration first
  4. Use the interactive setup to validate settings
  5. Check that all required fields are present

Next Steps

Now that you’ve configured your application: