add-branding

Customizes Mojaiks app shell branding by editing declarative JSON configs and validating assets and API responses.

14|1|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/BlocUnited-LLC/mozaiks --skill add-branding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-branding
Source: https://github.com/BlocUnited-LLC/mozaiks/tree/main/.claude/skills/add-branding
Command: npx skills add https://github.com/BlocUnited-LLC/mozaiks --skill add-branding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the guesswork and trial-and-error involved in customizing the Mozaiks app shell’s branding by showing exactly which declarative files control themes, navigation, and logos.

Core Features & Use Cases

  • Theme customization: Update visual design tokens (colors/fonts/spacing and dark-light behavior) via app/brand/theme_config.json to keep styling consistent.
  • Shell chrome configuration: Modify header, footer, profile, notifications, and mobile behavior using app/config/shell.json and its shortcuts/navigation/chrome sections.
  • Brand asset management: Replace or add logos, icons, and fonts in app/brand/assets/ and app/brand/fonts/ so UI references resolve correctly.
  • Use Case: You want a dashboard-first experience with a compact workspace feel, updated branding, and correct placement rules for navigation and chat/workflow entry.

Quick Start

Tell the AI what you want to change (theme colors, logos/icons, navigation placement, and which pages should use which shell mode), and apply the suggested edits to app/brand/ and app/config/ accordingly.

Frequently Asked Questions about add-branding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize the app shell branding and theme configuration?

App shell branding is customized by updating declarative configuration files, specifically app/config/shell.json and app/brand/theme_config.json. You align theme tokens, navigation placement, and chrome behavior to modify the app-wide shell UI or route-level shell modes.

Where do I manage logos and fonts for theme customization?

Theme customization assets like logos, icons, and fonts are managed under the app/brand/assets/ and app/brand/fonts/ directories. The system validates that referenced assets exist and resulting API responses match expectations to ensure UI references resolve correctly.

Can I configure different shell modes for dashboards and immersive experiences?

Yes, shell chrome configuration supports route-level shell modes for dashboards, conversations, and focused or immersive experiences. You modify header, footer, profile, notifications, and mobile behavior using app/config/shell.json and its shortcuts, navigation, and chrome sections.

What is declarative UI branding and how does it handle dark-light behavior?

Declarative UI branding removes trial-and-error by explicitly defining visual design tokens for colors, fonts, spacing, and dark-light behavior. Updates are applied via app/brand/theme_config.json to keep styling consistent across the app shell.

Why does my navigation placement not update after changing the shell chrome?

Navigation placement issues occur when referenced brand assets are missing or declarative configuration files are misaligned. The system validates that assets under app/brand/ exist and that shell.json and theme_config.json updates match expected API responses.

Does this declarative branding approach work for a dashboard-first workspace?

Yes, declarative branding supports a dashboard-first experience with a compact workspace feel. You specify desired theme colors, logos, navigation placement rules, and chat or workflow entry points, then apply suggested edits to app/brand/ and app/config/ files.