BrandparserInvite Only
Schemas

Brand Analysis

The top-level analysis object containing all section results.

Properties

thingsThingsSection

Factual identity: what the brand is, does, and for whom

namestring

Exact brand/product name as it appears on the website

Example: "Brandparser"

descriptionstring

One sentence: what it is and what it does

Example: "Brandparser is an AI-powered platform that extracts brand guidelines from any public website."

purposestring

Primary use case or problem it solves

capabilitiesstring[]

3–8 main features or capabilities

categorystring

Business category (e.g., "SaaS platform", "design agency")

missionMissionSection

Brand purpose, vision, values, and promise

mission_statementobject
statementstring

Concise mission statement

explanationstring

Supporting context

visionobject
statementstring

Vision statement

explanationstring

Supporting context

core_valuesobject[]

2–5 guiding principles

titlestring

Value name

descriptionstring

What this value means

icon_type"target" | "star" | "shield" | "heart" | "lightbulb" | "checkmark" | "arrow" | "chart" | "people" | "globe"

UI icon hint

brand_promiseobject
titlestring

Promise statement

descriptionstring

Full explanation

usage_contextstring[]

Contexts where promise applies

icon_typestring

UI icon hint

audiencesAudiencesSection

Target audience personas. Note: `image_path` is always `null` for API parses — headshot images are only generated for app users.

personasobject[]

2–3 synthetic personas representing the target audience

namestring

Realistic full name

gender"woman" | "man" | "person"
ethnicitystring

Ethnicity for diverse representation

rolestring

Job title

challengestring

Primary pain point

industrystring

Industry or sector

business_contextstring

Company context (e.g., "Series A startup, 30 people")

goalsstring

Primary objectives

pain_pointsstring

Additional pain points

image_pathstring | null

Path to persona headshot image. Always null for API parses.

toneToneSection

Brand voice, writing style, and LLM copy generation prompts

voice_traitsobject[]

2–6 characteristic voice traits with do/don't examples

namestring

Voice trait name

correct_examplestring

Example phrase demonstrating this trait

incorrect_examplestring

Example phrase violating this trait

explanationstring

Brief explanation

example_phrasesobject
we_saystring[]

Real phrases from the website

we_dont_saystring[]

Phrases that would feel off-brand

style_guidelinesobject[]

Concrete writing rules

categorystring

Rule category

rulestring

The rule in plain English

examplestring

Example: "correct — not: wrong"

voice_summarystring

2–3 sentence summary of overall voice

llm_promptsobject

Ready-to-use prompts for LLM copy generation in brand voice

system_promptstring

Full system prompt for copy generation

writing_instructionsstring

Inline writing instructions for shorter tasks

quick_referencestring

2–3 sentence quick-reference summary

logosLogosResult

Logo system with a type × variant matrix (mark, wordmark, combo, stacked × light/dark) plus standalone slots (icon, social, monotone)

slotsobject

Logo assets keyed by slot name. Null value means the slot is empty.

Example: {"mark_light":{"asset_path":"brands/abc/mark-light.svg","format":"svg","is_vector":true,"width":null,"height":null},"mark_dark":{"asset_path":"brands/abc/mark-dark.svg","format":"svg","is_vector":true,"width":null,"height":null,"generated":true},"wordmark_light":{"asset_path":"brands/abc/wordmark.svg","format":"svg","is_vector":true,"width":null,"height":null},"wordmark_dark":null}

slot_definitionsLogoSlotDefinition[]

Canonical slot definitions describing each logo slot

key"mark_light" | "mark_dark" | "wordmark_light" | "wordmark_dark" | "combo_light" | "combo_dark" | "stacked_light" | "stacked_dark" | "icon" | "social" | "monotone"required

Slot key identifier

labelstringrequired

Human-readable slot label

descriptionstringrequired

What this logo slot is used for

primary_logoobject

Legacy: primary logo (highest confidence). Use slots instead.

variantsobject[]

Legacy: all logo variants. Use slots instead.

faviconobject

Legacy: best favicon asset. Use slots.icon instead.

colorsColorsSection

Complete brand color system with palette, buttons, neutrals, pairings, dark mode, and accessibility

primary_palettePaletteColor[]

Primary colors sorted by usage frequency

namestring

Color name (e.g., "Midnight Blue")

hexstring

Hex color value

Example: "#1a2b3c"

rgbastring

RGBA color value

hslstring

HSL color value

usagestring

Where this color appears

category"primary" | "secondary" | "accent" | "neutral"
usage_frequencynumber

0–100 scale indicating how often this color is used

contextsstring[]

Where on the page this color appears

is_gradientboolean
gradient_definitionstring

CSS gradient definition (if is_gradient is true)

recommended_usage_percentstring

Recommended usage percentage (e.g., "55-65")

button_colorsobject[]

Button color variants (Primary, Secondary, Ghost, etc.)

labelstring
background_hexstring
background_rgbastring
text_hexstring
text_rgbastring
border_hexstring
border_rgbastring
hover_background_hexstring
hover_background_rgbastring
usagestring
accessibilityAccessibilityMetrics

WCAG accessibility metrics for a color pairing

supporting_colorsobject[]

Grays, whites, blacks, and other neutrals

namestring
hexstring
rgbastring
hslstring
usagestring
color_pairingsobject[]

Effective foreground/background color combinations

foreground_hexstring
background_hexstring
usagestring
accessibilityAccessibilityMetrics

WCAG accessibility metrics for a color pairing

recommendedboolean
dark_modeobject

Dark mode color analysis

detected"yes" | "no" | "partial"
generatedboolean

Whether dark mode colors were synthesized vs extracted

dark_mode_colorsobject[]
usage_guidelinesstring[]

Best-practice guidelines for applying the color system

design_notesstring

Overall observations about the color system

accessibilityobject

Top-level accessibility summary

overall_score"good" | "needs_improvement" | "poor"
recommendationsstring[]
contrast_issuesobject[]
typographyTypographySection

Complete brand type system: fonts, headings, body, labels, links, buttons

font_familiesobject[]

Font families used by the brand

namestring

Font name (e.g., "Inter")

usagestring

Where the font is used

availabilityobject

Font availability and licensing info

headingsobject[]

Heading styles from hero to h6

level"hero" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6"
labelstring
font_sizestring

Example: "52px"

font_weightstring

Example: "700"

line_heightstring

Example: "1.2"

letter_spacingstring
example_text_colorstring
example_background_colorstring
text_transform"none" | "uppercase" | "lowercase" | "capitalize"
special_effectsstring
usagestring
labelsobject[]

Small uppercase labels, eyebrows, overlines

labelstring
font_sizestring
font_weightstring
text_transformstring
letter_spacingstring
example_text_colorstring
usagestring
body_textobject[]

Body text styles

labelstring
font_sizestring
font_weightstring
line_heightstring
example_text_colorstring
usagestring
linksobject[]

Link styles

labelstring
font_sizestring
font_weightstring
text_decorationstring
hover_colorstring
example_text_colorstring
usagestring
buttonsobject[]

Button typography styles

labelstring
font_sizestring
font_weightstring
background_colorstring
paddingstring
border_radiusstring
borderstring
hover_backgroundstring
example_text_colorstring
usagestring
blockquotesobject[]

Blockquote/testimonial styles

labelstring
font_sizestring
font_weightstring
line_heightstring
font_style"normal" | "italic"
border_leftstring
paddingstring
example_text_colorstring
usagestring
design_notesstring

Overall observations about the type system

imagesImagesSection

Photography, illustration, icon, and product imagery analysis with downloaded assets

summaryobject

Overall image mood summary

overall_moodobject
photographic_styleobject

Photography style analysis (absent if no photography found)

subjectsobject
compositionobject
lighting_and_colorobject
people_and_charactersobject
backgrounds_and_environmentsobject
examplesImageExample[]
illustration_styleobject

Illustration style analysis (absent if no illustrations found)

style_keywordsstring[]
techniquestring
color_usagestring
line_and_shape_languagestring
character_designstring
examplesImageExample[]
icon_styleobject

Icon style analysis (absent if no custom icons found)

visual_styleobject
usage_contextsstring[]
possible_libraryobject
examplesImageExample[]
product_imageryobject

Product/UI imagery analysis

ui_screenshotsobject
code_snippet_styleobject
assetsobject

Downloaded image and icon assets

imagesAssetFile[]
iconsAssetFile[]
art-directionArtDirectionSection

Visual language, design guidelines, and narrative-to-visual mapping

aesthetic_languageobject
style_descriptorsobject[]

2–8 evocative style descriptors

overall_aestheticstring

1–2 sentence summary of overall aesthetic

visual_guidelinesobject
guidelines_summarystring
guidelinesobject[]
narrative_to_visualobject
visual_storytellingstring
visual_narrative_elementsobject[]
art_direction_summarystring

2–3 sentence summary of full art direction

design_elementsobject[]

Specific UI/design moments exemplifying the visual language

descriptionstring
significancestring
screenshot_indexinteger
regionobject
llm_image_promptobject

Ready-to-use prompt for image generation models

promptstring

Complete copyable prompt

optimised_forstring

Model this prompt is optimized for

northstart-statementNorthstartStatementSection

Proprietary 14-field positioning framework synthesizing all prior analysis stages. All values are lowercase with minimal prose.

situation_contextstring

Gerund phrase describing the situation (3–8 words)

Example: "juggling business and personal responsibilities"

target_audiencestring

Noun phrase for the audience (2–5 words)

Example: "busy entrepreneurs"

pain_pointstring

Core pain point as a noun phrase (3–8 words)

motivation_goalstring

Infinitive phrase for the goal (4–8 words)

Example: "put their marketing on autopilot"

desired_outcomestring

Desired end state (3–8 words)

belief_aspirationstring

Reflects brand WHY/mission (4–8 words)

product_namestring

Exact brand or product name

product_categorystring

Article + noun phrase (e.g., "an AI-assisted marketing platform")

core_benefitstring

Primary benefit (4–10 words)

how_it_worksstring

Mechanism (4–10 words)

competitor_alternativestring

What the audience uses instead (3–8 words)

competitor_limitationstring

Specific weakness of the alternative (4–10 words)

differentiatorstring

Unique advantage (4–10 words)

transformationstring

Specific outcome delivered (4–10 words)

Example: "a complete brand guide in under five minutes"

webWebSection

Manually-curated frontend toolkit preferences — component libraries, CSS framework, runtime, accessibility, and coding patterns. This section has no auto-analysis; it is populated by the user.

component_librariesWebLibraryEntry[]

UI component libraries used by the brand

namestringrequired

Example: "shadcn/ui"

urlstring | null
versionstring | null

Example: "2.x"

notesstring | null
css_frameworkobject | null

CSS framework or styling approach

namestring

Example: "Tailwind CSS"

versionstring | null

Example: "4.x"

theme_config_urlstring | null

Link to the theme or config file

notesstring | null
icon_librariesWebLibraryEntry[]

Icon sets used by the brand

namestringrequired

Example: "shadcn/ui"

urlstring | null
versionstring | null

Example: "2.x"

notesstring | null
meta_frameworksWebLibraryEntry[]

Meta-frameworks (e.g. Next.js, Nuxt)

namestringrequired

Example: "shadcn/ui"

urlstring | null
versionstring | null

Example: "2.x"

notesstring | null
state_managementWebLibraryEntry[]

State management libraries

namestringrequired

Example: "shadcn/ui"

urlstring | null
versionstring | null

Example: "2.x"

notesstring | null
authWebLibraryEntry[]

Authentication libraries and providers

namestringrequired

Example: "shadcn/ui"

urlstring | null
versionstring | null

Example: "2.x"

notesstring | null
languagestring | null

Programming language and strictness level

Example: "TypeScript (strict)"

runtimestring | null

Runtime environment

Example: "Node 22"

package_managerstring | null

Package manager

Example: "pnpm"

accessibilitystring | null

Accessibility standard target

Example: "WCAG 2.2 AA"

animationobject | null

Animation and motion preferences

librarystring | null

Animation library or approach

Example: "Framer Motion"

reduced_motionboolean

Whether to honour prefers-reduced-motion

notesstring | null
deploymentWebLibraryEntry[]

Deployment platforms and hosting providers

namestringrequired

Example: "shadcn/ui"

urlstring | null
versionstring | null

Example: "2.x"

notesstring | null
design_tokensobject | null

Freeform design tokens (spacing, radius, shadows)

preferred_patternsstring[]

Preferred coding patterns (e.g. "server components", "app router")

custom_urlsobject[]

Reference links (Storybook, Figma, etc.)

labelstring

Example: "Storybook"

urlstring
notesstring | null

Free-text notes

Example
example.json
{
  "things": {
    "name": "Brandparser",
    "description": "Brandparser is an AI-powered platform that extracts brand guidelines from any public website.",
    "purpose": "string",
    "capabilities": [
      "string"
    ],
    "category": "string"
  },
  "mission": {
    "mission_statement": {
      "statement": "string",
      "explanation": "string"
    },
    "vision": {
      "statement": "string",
      "explanation": "string"
    },
    "core_values": [
      {
        "title": "string",
        "description": "string",
        "icon_type": "target"
      }
    ],
    "brand_promise": {
      "title": "string",
      "description": "string",
      "usage_context": [
        "string"
      ],
      "icon_type": "string"
    }
  },
  "audiences": {
    "personas": [
      {
        "name": "string",
        "gender": "woman",
        "ethnicity": "string",
        "role": "string",
        "challenge": "string",
        "industry": "string",
        "business_context": "string",
        "goals": "string",
        "pain_points": "string",
        "image_path": null
      }
    ]
  },
  "tone": {
    "voice_traits": [
      {
        "name": "string",
        "correct_example": "string",
        "incorrect_example": "string",
        "explanation": "string"
      }
    ],
    "example_phrases": {
      "we_say": [
        "string"
      ],
      "we_dont_say": [
        "string"
      ]
    },
    "style_guidelines": [
      {
        "category": "string",
        "rule": "string",
        "example": "string"
      }
    ],
    "voice_summary": "string",
    "llm_prompts": {
      "system_prompt": "string",
      "writing_instructions": "string",
      "quick_reference": "string"
    }
  },
  "logos": {
    "slots": {
      "mark_light": {
        "asset_path": "brands/abc/mark-light.svg",
        "format": "svg",
        "is_vector": true,
        "width": null,
        "height": null
      },
      "mark_dark": {
        "asset_path": "brands/abc/mark-dark.svg",
        "format": "svg",
        "is_vector": true,
        "width": null,
        "height": null,
        "generated": true
      },
      "wordmark_light": {
        "asset_path": "brands/abc/wordmark.svg",
        "format": "svg",
        "is_vector": true,
        "width": null,
        "height": null
      },
      "wordmark_dark": null
    },
    "slot_definitions": [
      {
        "key": "mark_light",
        "label": "string",
        "description": "string"
      }
    ],
    "primary_logo": "...",
    "variants": [
      "..."
    ],
    "favicon": "..."
  },
  "colors": {
    "primary_palette": [
      {
        "name": "string",
        "hex": "#1a2b3c",
        "rgba": "string",
        "hsl": "string",
        "usage": "string",
        "category": "primary",
        "usage_frequency": 0,
        "contexts": [
          "string"
        ],
        "is_gradient": true,
        "gradient_definition": "string",
        "recommended_usage_percent": "string"
      }
    ],
    "button_colors": [
      {
        "label": "string",
        "background_hex": "string",
        "background_rgba": "string",
        "text_hex": "string",
        "text_rgba": "string",
        "border_hex": "string",
        "border_rgba": "string",
        "hover_background_hex": "string",
        "hover_background_rgba": "string",
        "usage": "string",
        "accessibility": {
          "contrast_ratio": 0,
          "wcag_aa": true,
          "wcag_aaa": true,
          "wcag_large_text_aa": true
        }
      }
    ],
    "supporting_colors": [
      {
        "name": "string",
        "hex": "string",
        "rgba": "string",
        "hsl": "string",
        "usage": "string"
      }
    ],
    "color_pairings": [
      {
        "foreground_hex": "string",
        "background_hex": "string",
        "usage": "string",
        "accessibility": "...",
        "recommended": true
      }
    ],
    "dark_mode": {
      "detected": "yes",
      "generated": true,
      "dark_mode_colors": [
        {
          "name": "string",
          "hex": "string",
          "rgba": "string",
          "hsl": "string",
          "usage": "string",
          "light_mode_equivalent": "string"
        }
      ]
    },
    "usage_guidelines": [
      "string"
    ],
    "design_notes": "string",
    "accessibility": {
      "overall_score": "good",
      "recommendations": [
        "string"
      ],
      "contrast_issues": [
        {
          "type": "string",
          "element": "string",
          "foreground_hex": "string",
          "background_hex": "string",
          "contrast_ratio": 0,
          "meets_wcag_aa": true,
          "recommendation": "string"
        }
      ]
    }
  },
  "typography": {
    "font_families": [
      {
        "name": "string",
        "usage": "string",
        "availability": {
          "availability": "system",
          "requires_license": true,
          "foundry": "string",
          "license_type": "string",
          "recommended_alternative": "string",
          "alternative_rationale": "string",
          "notes": "string",
          "google_fonts_css_url": "string",
          "bunny_fonts_css_url": "string"
        }
      }
    ],
    "headings": [
      {
        "level": "hero",
        "label": "string",
        "font_size": "52px",
        "font_weight": "700",
        "line_height": "1.2",
        "letter_spacing": "string",
        "example_text_color": "string",
        "example_background_color": "string",
        "text_transform": "none",
        "special_effects": "string",
        "usage": "string"
      }
    ],
    "labels": [
      {
        "label": "string",
        "font_size": "string",
        "font_weight": "string",
        "text_transform": "string",
        "letter_spacing": "string",
        "example_text_color": "string",
        "usage": "string"
      }
    ],
    "body_text": [
      {
        "label": "string",
        "font_size": "string",
        "font_weight": "string",
        "line_height": "string",
        "example_text_color": "string",
        "usage": "string"
      }
    ],
    "links": [
      {
        "label": "string",
        "font_size": "string",
        "font_weight": "string",
        "text_decoration": "string",
        "hover_color": "string",
        "example_text_color": "string",
        "usage": "string"
      }
    ],
    "buttons": [
      {
        "label": "string",
        "font_size": "string",
        "font_weight": "string",
        "background_color": "string",
        "padding": "string",
        "border_radius": "string",
        "border": "string",
        "hover_background": "string",
        "example_text_color": "string",
        "usage": "string"
      }
    ],
    "blockquotes": [
      {
        "label": "string",
        "font_size": "string",
        "font_weight": "string",
        "line_height": "string",
        "font_style": "normal",
        "border_left": "string",
        "padding": "string",
        "example_text_color": "string",
        "usage": "string"
      }
    ],
    "design_notes": "string"
  },
  "images": {
    "summary": {
      "overall_mood": {
        "keywords": [
          "string"
        ],
        "description": "string"
      }
    },
    "photographic_style": {
      "subjects": {
        "primary": [
          "string"
        ],
        "secondary": [
          "string"
        ]
      },
      "composition": {
        "framing": [
          "string"
        ],
        "camera_angles": [
          "string"
        ],
        "layout": [
          "string"
        ],
        "notes": "string"
      },
      "lighting_and_color": {
        "lighting": [
          "string"
        ],
        "contrast": "low",
        "palette_relation_to_brand_colors": "string",
        "notes": "string"
      },
      "people_and_characters": {
        "diversity_notes": "string",
        "styling": [
          "string"
        ],
        "emotional_tone": [
          "string"
        ]
      },
      "backgrounds_and_environments": {
        "types": [
          "string"
        ],
        "depth_of_field": "string",
        "use_of_gradients_or_textures": "string"
      },
      "examples": [
        {
          "role": "string",
          "description": "string",
          "page_context": "string"
        }
      ]
    },
    "illustration_style": {
      "style_keywords": [
        "string"
      ],
      "technique": "string",
      "color_usage": "string",
      "line_and_shape_language": "string",
      "character_design": "string",
      "examples": [
        "..."
      ]
    },
    "icon_style": {
      "visual_style": {
        "stroke_vs_fill": "string",
        "stroke_weight": "string",
        "corner_radius": "string",
        "metaphor_style": [
          "string"
        ],
        "consistency_notes": "string"
      },
      "usage_contexts": [
        "string"
      ],
      "possible_library": {
        "name": "string",
        "notes": "string"
      },
      "examples": [
        "..."
      ]
    },
    "product_imagery": {
      "ui_screenshots": {
        "layout_and_chrome": [
          "string"
        ],
        "backgrounds": [
          "string"
        ],
        "color_and_mood": [
          "string"
        ],
        "accent_details": [
          "string"
        ],
        "composition": [
          "string"
        ],
        "avoid": [
          "string"
        ],
        "examples": [
          "..."
        ]
      },
      "code_snippet_style": {
        "editor_treatment": [
          "string"
        ],
        "syntax_colors": [
          "string"
        ],
        "language_or_content": [
          "string"
        ],
        "avoid": [
          "string"
        ],
        "examples": [
          "..."
        ]
      }
    },
    "assets": {
      "images": [
        {
          "url": "string",
          "r2_key": "string",
          "role": "string",
          "description": "string",
          "alt": "string",
          "classes": "string",
          "library_guess": "string",
          "page_url": "string"
        }
      ],
      "icons": [
        "..."
      ]
    }
  },
  "art-direction": {
    "aesthetic_language": {
      "style_descriptors": [
        {
          "name": "string",
          "means": "string",
          "avoids": "string"
        }
      ],
      "overall_aesthetic": "string"
    },
    "visual_guidelines": {
      "guidelines_summary": "string",
      "guidelines": [
        {
          "name": "string",
          "guideline": "string",
          "applies_to": "string",
          "how_to_apply": "string"
        }
      ]
    },
    "narrative_to_visual": {
      "visual_storytelling": "string",
      "visual_narrative_elements": [
        {
          "narrative_aspect": "string",
          "visual_expression": "string"
        }
      ]
    },
    "art_direction_summary": "string",
    "design_elements": [
      {
        "description": "string",
        "significance": "string",
        "screenshot_index": 0,
        "region": {
          "x": 0,
          "y": 0,
          "width": 0,
          "height": 0
        }
      }
    ],
    "llm_image_prompt": {
      "prompt": "string",
      "optimised_for": "string"
    }
  },
  "northstart-statement": {
    "situation_context": "juggling business and personal responsibilities",
    "target_audience": "busy entrepreneurs",
    "pain_point": "string",
    "motivation_goal": "put their marketing on autopilot",
    "desired_outcome": "string",
    "belief_aspiration": "string",
    "product_name": "string",
    "product_category": "string",
    "core_benefit": "string",
    "how_it_works": "string",
    "competitor_alternative": "string",
    "competitor_limitation": "string",
    "differentiator": "string",
    "transformation": "a complete brand guide in under five minutes"
  },
  "web": {
    "component_libraries": [
      {
        "name": "shadcn/ui",
        "url": null,
        "version": "2.x",
        "notes": null
      }
    ],
    "css_framework": {
      "name": "Tailwind CSS",
      "version": "4.x",
      "theme_config_url": null,
      "notes": null
    },
    "icon_libraries": [
      "..."
    ],
    "meta_frameworks": [
      "..."
    ],
    "state_management": [
      "..."
    ],
    "auth": [
      "..."
    ],
    "language": "TypeScript (strict)",
    "runtime": "Node 22",
    "package_manager": "pnpm",
    "accessibility": "WCAG 2.2 AA",
    "animation": {
      "library": "Framer Motion",
      "reduced_motion": true,
      "notes": null
    },
    "deployment": [
      "..."
    ],
    "design_tokens": null,
    "preferred_patterns": [
      "string"
    ],
    "custom_urls": [
      {
        "label": "Storybook",
        "url": "string"
      }
    ],
    "notes": null
  }
}

Audiences

Target audience personas with demographics and pain points.

Colors

Complete brand color system with palette, buttons, pairings, dark mode, and accessibility.