Skip to main content

Architecture

The Branding Assistant follows a layered architecture that separates concerns and enables reusability across different products and branding needs.

Conceptual Architecture

┌───────────────────────┐
│ Project Definition     │  (JSON / YAML / Struct)
│  - Name, Mission       │
│  - Tone, Visual DNA    │
│  - Mascot / Abstract   │
└───────────┬───────────┘


┌───────────────────────┐
│ Brand Normalization    │
│  - Brand Anchor        │
│  - Visual Vocabulary   │
│  - Constraints         │
└───────────┬───────────┘


┌───────────────────────┐
│ Prompt Modules         │  (Reusable)
│  - Logo Module         │
│  - Banner Module       │
│  - Animation Module    │
│  - Social Module       │
└───────────┬───────────┘


┌───────────────────────┐
│ Model Router           │
│  - Static vs Motion    │
│  - Fidelity Needs      │
│  - Cost / Speed        │
└───────────┬───────────┘


┌───────────────────────┐
│ Media Outputs          │
│  - PNG / SVG           │
│  - GIF / MP4           │
│  - Prompt Provenance   │
└───────────────────────┘

Brand Normalization Layer

Converts project input into a Brand Anchor - a consistent text block injected into every prompt.

Brand Anchor Example

“Sparki.tools is a terminal-first developer tool focused on effortless CI/CD. The brand is modern, confident, minimal, and craftsmanship-driven. Visuals should feel precise, dark-mode native, and subtly kinetic.”

Visual Vocabulary

Derived attributes that feed all downstream modules:
  • Motion level: subtle, intentional
  • Complexity: low
  • Emotional register: calm confidence
  • Metaphors: sparks, pipelines, orchestration

Prompt Module System

Each Prompt Module is reusable across products and contains:
ComponentDescription
PurposeWhat the module generates
Model SuitabilityWhich LLMs work best
Prompt TemplateParameterized prompt structure
Output RequirementsFile formats and variants

Available Modules

  1. Logo Module - Primary logo, icon, and wordmark
  2. Hero Banner Module - Website and README hero visuals
  3. Animation Module - Motion branding (mascot idle, system behavior)
  4. Social Module - High-impact announcement graphics

Model Routing Rules

Asset TypeModelRationale
LogosGrok ImagineSharp composition, static precision
BannersGrok ImagineUI + brand coherence
AnimationsSoraTemporal consistency, looping
Social CardsGrok ImagineHigh contrast, fast iteration

Output Contract

Every generated asset includes:
  • Prompt used
  • Brand anchor version
  • Timestamp
  • Intended use (logo, hero, etc.)
This enables traceability and regeneration.