Part 20: Settings, Appearance & The Troubleshooting Bible

1. System Settings Navigation

Access the Settings Modal via the header gear icon. The multi-panel modal features a real-time instant search bar (Find a setting...) spanning 13 configuration tabs:

Engine & API AI Configuration, Gemini API Key, Model Fallbacks, Image Generation.

Parameters & Agents LLM Parameters, Multi-Agent Systems, MCP Tools, Custom Skills.

Cloud & Data Appearance & Themes, Fact Memory, Google Drive Cloud, Local Backup & Export.

2. Appearance & Palette Themes

Customize the editor UI workspace with 3 instant themes saved in browser storage:

🌙 Dark Mode (Default)

Deep midnight contrast (#0f172a) optimized for late-night coding sessions and OLED power savings.

☀️ Light Mode

Crisp daytime readability with bright cards, clear contrast, and slate typography for office environments.

📜 Sepia Warm Mode

Eye-safe warm reading palette (#fbf0d9) that minimizes blue light exposure during long reading sessions.

3. LLM Parameter Engine Tuning

Fine-tune model generation characteristics under Settings → LLM Parameter Engine:

Sampling Temperature (0.0 – 2.0): Set to 0.0 - 0.3 for deterministic code and factual tasks. Use 0.7 - 1.0 for general chat, and 1.2 - 2.0 for creative brainstorming.

Global System Instructions: Inject custom system prompts ahead of every chat execution (e.g. "Always respond in TypeScript with Tailwind utility classes").

4. The Comprehensive Troubleshooting Bible

Bookmark this matrix for instant fixes to common runtime issues across providers, contexts, sandboxes, and cloud storage:

A. Provider & API Connection Errors

"Please select an AI model before starting the chat": Open the Model Organizer (click model pill) → Choose Provider Puter.js → Equip at least one model card.
"Gemini API key rejected (401)": Obtain a new key from aistudio.google.com/app/apikey. Ensure the Generative Language API is enabled in Google Cloud Console.
"Gemini quota or rate limit reached (429)": Enable Pollinations AI fallback in Settings → Image Generation or set up fallback chains in Model Organizer.
"Local Ollama Disconnected / CORS": Launch Ollama with CORS origins allowed: OLLAMA_ORIGINS="*" ollama serve.

B. Context, Image & File Errors

"Context Used: 95% / 100%": Unpin unused files from the Project Context bar, or start a New Chat inside the active folder to reset context.
"Model cannot see images": Switch to a model bearing the Visual badge (e.g. Gemini 3.5 Flash, GPT-4o, Claude 3.5 Sonnet).
"Image Generation Safety Refusal": Rephrase prompts to avoid restricted trademarks or brand names.

C. Web Sandbox & Preview Errors

Blank White Preview Screen: Open Web Sandbox → inspect the Console drawer for missing imports (e.g. useState) or missing default exports.
Unstyled Tailwind Components: Ensure src/index.css contains @import "tailwindcss"; or index.html includes the CDN script.
GitHub Push 401 Bad Credentials: Generate a GitHub PAT with the repo scope enabled.