> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nomiq.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Logos, Colors & Typography in the Nomiq Brand Studio

> Manipulate logos, tune color palettes, and refine typography pairings in the Brand Studio editor to produce pixel-perfect brand visuals.

The Brand Studio's visual editor gives you direct, granular control over the three pillars of your visual identity: logos, colors, and typography. Nomiq's Visual Engine generates these assets automatically from your locked Brand Strategy, but the editor lets you dial in precise tweaks — swap a logo symbol, lock a hex value, or shift your typographic scale — without breaking the mathematical rules that keep your brand accessible and cohesive.

## How the Visual Engine Works

Every asset Nomiq produces passes through a rules-based Visual Engine that sits on top of the AI model. The engine enforces graphic design principles — contrast ratios, clearspace minimums, and typographic hierarchy — so your output meets professional standards by default.

<Frame>
  ```mermaid theme={null}
  flowchart TD
      A([Brand Strategy Context]) --> B{Visual Engine}
      B --> C[Logo Composition]
      B --> D[Color Accessibility]
      B --> E[Typographic Scaling]

      C --> F((Final Asset))
      D --> F
      E --> F

      classDef default fill:#111,stroke:#333,stroke-width:1px,color:#fff,rx:8px,ry:8px;
      classDef engine fill:#6366f1,stroke:#4f46e5,stroke-width:1px,color:#fff,rx:8px,ry:8px;
      class B engine;
  ```
</Frame>

Your Brand Strategy — the voice, mission, and name you locked earlier — flows into the Visual Engine as contextual seed data. The engine uses it to select symbol categories, pick color temperature, and choose typeface archetypes that match your brand's personality before you touch a single slider.

## The Three Visual Pillars

<Steps>
  <Step title="Manipulate Your Logo">
    The logo is the anchor of your visual identity. Nomiq generates each logo as a combination of a custom typeset wordmark and a geometric SVG symbol.

    1. **Toggle the layout.** Click the logo canvas to switch between *Horizontal* (symbol left, wordmark right) and *Stacked* (symbol top, wordmark bottom). Use Horizontal for wide banners and navigation bars; use Stacked for square profile pictures and app icons.
    2. **Swap the symbol.** If you like the wordmark typography but not the generated symbol, open the **Symbol** tab and select a replacement from the contextual icon library. The library filters suggestions based on your industry and brand voice.
    3. **Set clearspace.** Drag the clearspace slider to define the minimum padding around your logo. This value is baked into every exported file so contractors and developers cannot accidentally crowd it against other elements.

    <Tip>
      If your brand name is longer than 15 characters, the Horizontal layout prevents the wordmark from wrapping awkwardly on small canvases. Switch to Stacked only for square-format applications like favicons or social media avatars.
    </Tip>
  </Step>

  <Step title="Tune Your Color Palette">
    Nomiq generates a five-slot color hierarchy — Background, Surface, Primary, Secondary, and Text — calculated to meet WCAG AA contrast requirements out of the box.

    1. **Lock swatches you want to keep.** Click the padlock icon on any color (for example, your existing brand Primary) before you regenerate. Locked swatches are excluded from the next generation cycle.
    2. **Regenerate the palette.** Click **Regenerate Palette**. Nomiq calculates new values for every unlocked slot that are mathematically complementary to your locked colors.
    3. **Override manually.** Click any swatch and type a precise HEX or HSL value. The editor immediately runs a contrast check and flags any pairing that fails AA standards.

    <Warning>
      Locking every swatch before regenerating prevents the AI from changing anything. If you want to explore variations, leave at least one slot unlocked so the engine has room to work.
    </Warning>
  </Step>

  <Step title="Refine Your Typography">
    Nomiq pairs open-source fonts for guaranteed web compatibility. Each project gets a **Display** font (used for H1–H3) and a **Body** font (used for paragraphs and UI labels), plus an auto-calculated typographic scale.

    1. **Switch the archetype pairing.** Open the **Typography** tab and toggle between *Serif*, *Sans-Serif*, and *Display* archetypes. Each archetype loads a curated font pair that matches your brand voice.
    2. **Adjust the Display weight.** Select the baseline font weight (e.g., 700 Bold or 900 Black) for your Display font. Heavier weights work for short, punchy headlines; lighter weights suit editorial brands.
    3. **Review the typographic scale.** Nomiq generates a CSS scale ratio (such as a 1.250 Major Third) automatically. Check the live preview to confirm your H1 is proportional to your Body text before you lock and export.

    <Note>
      Nomiq exclusively uses fonts with open-source licenses (Google Fonts or similar) to ensure you can legally embed them in your website and export them inside your Brand Kit without additional licensing fees.
    </Note>
  </Step>
</Steps>

## Professional Best Practices

* **Test your logo at 16 × 16 pixels.** If it looks like a blur at favicon size, simplify the symbol. Intricate geometric details vanish below 32 px.
* **Let the math choose complementary colors.** Lock your Primary and regenerate rather than manually guessing a Secondary. The engine produces mathematically precise complementary and analogous values every time.
* **Never set Body text in a Display font.** Highly stylized Display typefaces become illegible at 14 px. Reserve them for headlines only, and keep Body text in a clean, readable sans-serif or serif pairing.

## Common Mistakes

<CardGroup cols={2}>
  <Card title="Locking Every Variable" icon="lock" href="/brand-studio/core-identity#tune-your-color-palette">
    Locking all colors, the symbol, and the typography simultaneously leaves the AI nothing to adjust. If you ask for a "more playful" direction, the engine cannot comply. Always unlock at least one pillar before regenerating.
  </Card>

  <Card title="Ignoring Contrast Warnings" icon="triangle-exclamation" href="/brand-studio/core-identity#tune-your-color-palette">
    Forcing a light yellow Primary on a white Background fails WCAG AA standards. Publish with a contrast warning active and your brand will be inaccessible to users with low vision. Resolve every warning before exporting.
  </Card>

  <Card title="Using Stacked Layout for Long Names" icon="text-slash" href="/brand-studio/core-identity#manipulate-your-logo">
    A brand name exceeding 15 characters in the Stacked layout compresses the wordmark until it becomes unreadable at small sizes. Switch to Horizontal so the text can spread across a wider canvas.
  </Card>

  <Card title="Skipping the Scale Preview" icon="ruler" href="/brand-studio/core-identity#refine-your-typography">
    Accepting the default typographic scale without previewing it can leave you with an H1 that is only marginally larger than your Body text. Review the live scale before locking typography so the hierarchy reads clearly at a glance.
  </Card>
</CardGroup>

## Troubleshooting

| Problem                              | Likely Cause                                                                       | Solution                                                                                         |
| :----------------------------------- | :--------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
| **New color fails contrast check**   | Your Primary and Background colors lack sufficient luminosity difference.          | Darken the Primary, or switch the Background to a dark-mode value.                               |
| **Regeneration ignores your prompt** | All visual assets are locked, so the engine has no room to change anything.        | Click each padlock icon to unlock Colors and Typography, then regenerate.                        |
| **Logo wordmark looks squished**     | A long brand name does not fit the Stacked layout at small widths.                 | Switch the logo layout to Horizontal in the canvas toolbar.                                      |
| **Symbol tab shows no suggestions**  | Your Idea Prompt lacks industry context, so the library cannot filter suggestions. | Update your Idea Prompt with a specific product or service category, then reopen the Symbol tab. |
| **Font preview is blank**            | A slow network request failed to load the Google Fonts preview.                    | Refresh the Typography tab. If the issue persists, check your network connection.                |

## Related Pages

<CardGroup cols={2}>
  <Card title="Brand Strategy" icon="chess-knight" href="/brand-studio/brand-strategy">
    Learn how your locked mission, voice, and values seed the Visual Engine that produces your logos and colors.
  </Card>

  <Card title="Brand Guidelines" icon="book-open" href="/brand-studio/brand-guidelines">
    See how Nomiq compiles your locked visuals into a shareable, always-current interactive brand guideline document.
  </Card>

  <Card title="Exports & Kits" icon="download" href="/brand-studio/exports-and-kits">
    Download production-ready SVGs, PNGs, CSS variables, and a full Brand Kit ZIP once your visuals are locked.
  </Card>

  <Card title="AI Engine" icon="microchip" href="/ai-engine/how-ai-works">
    Explore advanced prompting techniques to guide the Visual Engine toward more precise outputs.
  </Card>
</CardGroup>
