add-app

name	add-app
description	Scaffold a new AI app config JSON file in contents/apps/ that passes the project's Zod schema validation. Use when creating a new AI application for the iHub platform.

Gather Requirements

Ask the user for:

• id: Unique app identifier (lowercase, hyphens, max 50 chars, e.g. my-new-app)
• name: Display name in English and German
• description: Short description in English and German
• system prompt: The AI system prompt in English and German
• icon: HeroIcon name (e.g. SparklesIcon, ChatBubbleLeftIcon, DocumentTextIcon)
• color: Hex color code (e.g. #4F46E5)

Note: apps no longer configure token limits. The context window and output cap come from the selected model (contextWindow / maxOutputTokens in the model config).

Create the Config File

Create contents/apps/{id}.json with this minimal valid shape:

{
  "id": "{id}",
  "name": {
    "en": "...",
    "de": "..."
  },
  "description": {
    "en": "...",
    "de": "..."
  },
  "color": "#4F46E5",
  "icon": "SparklesIcon",
  "system": {
    "en": "...",
    "de": "..."
  },
  "enabled": true
}

Optional Fields (add as needed)

{
  "order": 10,
  "preferredModel": "gpt-4o",
  "preferredOutputFormat": "markdown",
  "preferredTemperature": 0.7,
  "sendChatHistory": true,
  "messagePlaceholder": { "en": "Type your message...", "de": "Nachricht eingeben..." },
  "greeting": { "en": "Hello! How can I help?", "de": "Hallo! Wie kann ich helfen?" },
  "starterPrompts": [
    { "en": "Summarize this document", "de": "Dieses Dokument zusammenfassen" }
  ],
  "allowedModels": ["gpt-4o", "claude-opus-4-6"],
  "disallowModelSelection": false,
  "allowEmptyContent": false,
  "tools": ["webSearch", "calculator"],
  "features": { "magicPrompt": true },
  "upload": { "enabled": true, "maxSize": 10485760 },
  "variables": [
    {
      "id": "language",
      "type": "select",
      "label": { "en": "Language", "de": "Sprache" },
      "options": [
        { "value": "en", "label": { "en": "English", "de": "Englisch" } }
      ]
    }
  ]
}

Permissions

To restrict access to specific groups, add to contents/config/groups.json under the relevant group's permissions.apps array. Use "*" to allow all apps for a group.

Verify

After creating the file, check that the server loads it correctly:

timeout 10s node server/server.js 2>&1 | grep -E "error|{id}" | head -10

No server restart needed — apps are reloaded automatically via configCache.