{
  "$schema": "https://evenfan.example/brand-guidelines.schema.json",
  "brand": {
    "name": "Evenfan",
    "wordmark_case": "lowercase",
    "language": "it",
    "guidelines_version": "1.2",
    "guidelines_updated": "2026-05",
    "confidentiality": "internal_and_approved_partners",
    "guidelines_html": "index.html"
  },
  "assets": {
    "logo": {
      "type": "wordmark",
      "aspect_ratio": "1082:215",
      "viewbox": "0 0 1082 215",
      "sizing": {
        "min_px_digital": 120,
        "min_mm_print": 30,
        "acceptable_px_digital": 180,
        "acceptable_mm_print": 45,
        "recommended_px_digital": 300,
        "recommended_mm_print": 75,
        "navbar_height_px": [32, 40]
      },
      "clearspace": {
        "rule": "x equals the cap-height of the lowercase letter e in the wordmark",
        "example": "at 200px render width, x is about 20px",
        "applies_to_all_media": true
      },
      "variants": {
        "colori": {
          "description": "two-color wordmark: main body in Evenfan Blu, accents on the 'e' and dot of 'i' in Rosso Segnale",
          "colors_used": ["#0096D6", "#FF2D55"],
          "svg": "img/logo/svg/colori.svg",
          "png": {
            "on_white": "img/logo/png/colori su bianco.png",
            "on_transparent": "img/logo/png/colori su trasparente.png",
            "on_blue": "img/logo/png/colori su blu.png"
          }
        },
        "azzurro": {
          "description": "single-color wordmark in Evenfan Blu",
          "colors_used": ["#0096D6"],
          "svg": "img/logo/svg/azzurro.svg",
          "png": {
            "on_white": "img/logo/png/azzurro su bianco.png",
            "on_transparent": "img/logo/png/azzurro su trasparente.png",
            "on_blue": "img/logo/png/azzurro su blu.png"
          }
        },
        "blu": {
          "description": "single-color wordmark in Mezzanotte dark blue",
          "colors_used": ["#0F172A"],
          "svg": "img/logo/svg/blu.svg",
          "png": {
            "on_white": "img/logo/png/blu su bianco.png",
            "on_transparent": "img/logo/png/blu su trasparente.png",
            "on_blue": null
          }
        },
        "rosso": {
          "description": "single-color wordmark in Rosso Segnale",
          "colors_used": ["#FF2D55"],
          "svg": "img/logo/svg/rosso.svg",
          "png": {
            "on_white": "img/logo/png/rosso su bianco.png",
            "on_transparent": "img/logo/png/rosso su trasparente.png",
            "on_blue": "img/logo/png/rosso su blu.png"
          }
        },
        "bianco": {
          "description": "inverted wordmark in white, for dark or colored backgrounds",
          "colors_used": ["#FFFFFF"],
          "svg": "img/logo/svg/bianco.svg",
          "png": {
            "on_white": null,
            "on_transparent": "img/logo/png/bianco su trasparente.png",
            "on_blue": "img/logo/png/bianco su blu.png"
          }
        }
      }
    },
    "monogramma": {
      "type": "monogram",
      "derived_from": "letter e of the wordmark",
      "aspect_ratio": "1:1",
      "viewbox": "0 0 1667 1667",
      "sizing": {
        "min_px_digital": 24,
        "min_mm_print": 6,
        "acceptable_px_digital": 48,
        "acceptable_mm_print": 12,
        "recommended_px_digital": 80,
        "recommended_mm_print": 20
      },
      "clearspace": {
        "rule": "x equals the width of the horizontal stroke of the e",
        "example": "at 64px render size, x is about 8px"
      },
      "use_cases": ["app icon", "favicon", "social avatar", "compact mark"],
      "variants": {
        "colori": {
          "colors_used": ["#0096D6", "#FF2D55"],
          "svg": "img/monogramma/svg/colori.svg",
          "png": {
            "on_white": "img/monogramma/png/colori su bianco.png",
            "on_transparent": "img/monogramma/png/colori su trasparente.png",
            "on_blue": "img/monogramma/png/colori su blu.png"
          }
        },
        "azzurro": {
          "colors_used": ["#0096D6"],
          "svg": "img/monogramma/svg/azzurro.svg",
          "png": {
            "on_white": "img/monogramma/png/azzurro su bianco.png",
            "on_transparent": "img/monogramma/png/azzurro su trasparente.png",
            "on_blue": "img/monogramma/png/azzurro su blu.png"
          }
        },
        "blu": {
          "colors_used": ["#0F172A"],
          "svg": "img/monogramma/svg/blu.svg",
          "png": {
            "on_white": "img/monogramma/png/blu su bianco.png",
            "on_transparent": "img/monogramma/png/blu su trasparente.png",
            "on_blue": null
          }
        },
        "rosso": {
          "colors_used": ["#FF2D55"],
          "svg": "img/monogramma/svg/rosso.svg",
          "png": {
            "on_white": "img/monogramma/png/rosso su bianco.png",
            "on_transparent": "img/monogramma/png/rosso su trasparente.png",
            "on_blue": "img/monogramma/png/rosso su blu.png"
          }
        },
        "bianco": {
          "colors_used": ["#FFFFFF"],
          "svg": "img/monogramma/svg/bianco.svg",
          "png": {
            "on_white": null,
            "on_transparent": "img/monogramma/png/bianco su trasparente.png",
            "on_blue": "img/monogramma/png/bianco su blu.png"
          }
        }
      }
    }
  },
  "colors": {
    "primary": [
      {
        "id": "evenfan_blu",
        "name": "Evenfan Blu",
        "role": "primary brand color",
        "hex": "#0096D6",
        "rgb": [0, 150, 214],
        "cmyk": [72, 19, 0, 16],
        "hsl": [200, 100, 42],
        "pantone_coated": "2995 C",
        "usage": {
          "primary": ["primary logo", "CTA buttons", "links", "headings on white"],
          "secondary": ["hero backgrounds", "icon fills"],
          "avoid": ["body text on white when contrast falls below 3.5:1"]
        }
      },
      {
        "id": "rosso_segnale",
        "name": "Rosso Segnale",
        "role": "accent / emphasis",
        "hex": "#FF2D55",
        "rgb": [255, 45, 85],
        "cmyk": [0, 82, 67, 0],
        "hsl": [347, 100, 59],
        "pantone_coated": "185 C",
        "usage": {
          "primary": ["logo accent on 'e' and 'i' dot", "notification badges", "alerts"],
          "secondary": ["hover state on dark backgrounds"],
          "avoid": ["large background fills", "body text"]
        }
      },
      {
        "id": "mezzanotte",
        "name": "Mezzanotte",
        "role": "dark UI / inverted background",
        "hex": "#0F172A",
        "rgb": [15, 23, 42],
        "cmyk": [64, 45, 0, 84],
        "hsl": [222, 47, 11],
        "pantone_coated": "2767 C",
        "usage": {
          "primary": ["dark-mode logo fill", "dark UI backgrounds"],
          "secondary": ["navigation bars", "footer backgrounds"],
          "avoid": ["overuse; reserve for dark contexts"]
        }
      },
      {
        "id": "bianco",
        "name": "Bianco",
        "role": "light UI / body background",
        "hex": "#FFFFFF",
        "rgb": [255, 255, 255],
        "cmyk": [0, 0, 0, 0],
        "hsl": [null, null, 100],
        "pantone_coated": "Bright White",
        "usage": {
          "primary": ["page backgrounds", "card surfaces", "text on dark"],
          "secondary": ["inverted logo on colored backgrounds"],
          "avoid": ["cream or ivory alternatives"]
        }
      }
    ],
    "neutrals_ui_only": [
      { "id": "gelo",      "name": "Gelo",      "hex": "#F8FAFC" },
      { "id": "argento",   "name": "Argento",   "hex": "#E2E8F0" },
      { "id": "ardesia",   "name": "Ardesia",   "hex": "#94A3B8" },
      { "id": "grafite",   "name": "Grafite",   "hex": "#475569" },
      { "id": "inchiostro","name": "Inchiostro","hex": "#1E293B" }
    ],
    "neutrals_usage_rule": "UI only; never used inside the logo or mark applications"
  },
  "typography": {
    "fonts": [
      {
        "id": "readex_pro",
        "family": "Readex Pro",
        "classification": "sans-serif geometric",
        "role": "primary",
        "source": "Google Fonts",
        "license": "OFL",
        "weights_required": [300, 400, 500, 600, 700]
      },
      {
        "id": "dm_serif_display",
        "family": "DM Serif Display",
        "classification": "serif display",
        "role": "editorial",
        "source": "Google Fonts",
        "license": "OFL",
        "weights_required": [400],
        "italics_required": true
      },
      {
        "id": "dm_mono",
        "family": "DM Mono",
        "classification": "monospace",
        "role": "technical / tag",
        "source": "Google Fonts",
        "license": "OFL",
        "weights_required": [400, 500]
      }
    ],
    "scale": [
      { "style": "display",   "font": "DM Serif Display", "weight": 400, "size_px": 56, "line_height_px": 60, "italic_optional": true },
      { "style": "h1",        "font": "Readex Pro",       "weight": 600, "size_px": 40, "line_height_px": 48, "letter_spacing_em": -0.02 },
      { "style": "h2",        "font": "Readex Pro",       "weight": 600, "size_px": 28, "line_height_px": 36, "letter_spacing_em": -0.01 },
      { "style": "h3",        "font": "Readex Pro",       "weight": 500, "size_px": 20, "line_height_px": 28 },
      { "style": "body_large","font": "Readex Pro",       "weight": 400, "size_px": 18, "line_height_px": 28 },
      { "style": "body",      "font": "Readex Pro",       "weight": 400, "size_px": 16, "line_height_px": 26 },
      { "style": "label_ui",  "font": "Readex Pro",       "weight": 500, "size_px": 13, "line_height_px": 20, "letter_spacing_em": 0.02 },
      { "style": "eyebrow_tag","font": "DM Mono",         "weight": 500, "size_px": 11, "line_height_px": 16, "letter_spacing_em": 0.15, "text_transform": "uppercase" }
    ],
    "web_loading": {
      "font_display": "swap",
      "hosting_options": ["Google Fonts", "self-hosted"],
      "self_host_recommended_for_performance": true
    }
  },
  "voice": {
    "personality": [
      { "id": "focalizzata",   "label": "Focused",       "traits": ["gets to the point", "no corporate filler", "fast-paced"] },
      { "id": "comunitaria",   "label": "Community-first","traits": ["fan-to-fan tone", "never talks down", "shared story"] },
      { "id": "energica",      "label": "Energetic",     "traits": ["active verbs", "forward momentum", "sharp headlines"] },
      { "id": "trasparente",   "label": "Transparent",   "traits": ["clear on pricing", "clear on policies", "clear on process"] },
      { "id": "creativa",      "label": "Creative",      "traits": ["fan-culture references when appropriate", "avoid forced or cringe tone"] },
      { "id": "affidabile",    "label": "Reliable",      "traits": ["calm and precise in operational contexts (tickets, confirmations)"] }
    ],
    "do_dont": [
      {
        "context": "cta_buttons",
        "do":   ["Acquista biglietti", "Unisciti all'evento", "Trova la tua community"],
        "dont": ["Clicca qui", "Invia", "Prosegui"]
      },
      {
        "context": "empty_states",
        "do":   ["Ancora niente qui — sii il primo a creare un evento."],
        "dont": ["Nessun risultato trovato."]
      },
      {
        "context": "error_messages",
        "do":   ["Qualcosa è andato storto. Riprova."],
        "dont": ["Errore 500. Contatta il supporto."]
      },
      {
        "context": "confirmations",
        "do":   ["Ci sei! Abbiamo inviato il tuo biglietto nella casella email."],
        "dont": ["Transazione completata. Riferimento: #XZ8812."]
      },
      {
        "context": "marketing_headlines",
        "do":   ["Il tuo prossimo evento preferito è là fuori."],
        "dont": ["Ottimizza la tua esperienza di scoperta eventi."]
      },
      {
        "context": "legal_policy",
        "do":   ["plain language", "short sentences", "no passive voice"],
        "dont": ["dense legalese"]
      }
    ]
  },
  "backgrounds": {
    "approved": [
      { "background": "#FFFFFF", "logo_variant": "colori",  "contrast": "high" },
      { "background": "#F8FAFC", "logo_variant": "colori",  "contrast": "high" },
      { "background": "#0F172A", "logo_variant": "bianco",  "contrast": "high" },
      { "background": "#0096D6", "logo_variant": "bianco",  "contrast": "high" },
      { "background": "dark gradient (#1E293B → #0F172A)", "logo_variant": "bianco", "contrast": "high" }
    ],
    "avoid": [
      { "pattern": "similar-hue backgrounds to the logo colors (e.g. light blue under colored logo)" },
      { "pattern": "busy, non-brand gradients or photography without overlay" }
    ],
    "accessibility": {
      "wcag_level": "AA",
      "body_text_min_contrast": "4.5:1",
      "large_text_min_contrast": "3:1",
      "verify_surrounding_type_independently": true
    }
  },
  "misuse": {
    "logo_and_monogram": [
      { "id": "no_opacity",        "rule": "never use below 100% opacity" },
      { "id": "no_flip_or_mirror", "rule": "never mirror, flip, or rotate the orientation" },
      { "id": "no_distort",        "rule": "never stretch or squash; always scale with locked proportions" },
      { "id": "no_recolor",        "rule": "use only approved color variants" },
      { "id": "no_low_contrast_bg","rule": "never place on backgrounds that conflict with or wash out the mark" },
      { "id": "no_typographic_recreation", "rule": "the wordmark is custom drawn; never substitute it with any font, even similar ones" },
      { "id": "respect_clearspace","rule": "never let any element violate the clearspace zone" }
    ]
  },
  "digital_specs": {
    "web_screen": {
      "preferred_format": "SVG",
      "raster_fallback": "PNG @2x / @3x",
      "min_width_px": 120,
      "color_profile": "sRGB",
      "transparency_required": true,
      "navbar_logo_height_px": [32, 40]
    },
    "print": {
      "preferred_format": ["EPS", "vector PDF"],
      "color_mode": "CMYK (coated)",
      "min_width_mm": 30,
      "min_resolution_dpi": 300,
      "bleed_mm": 3,
      "spot_colors": ["Pantone 2995 C", "Pantone 185 C"]
    },
    "social_media": {
      "profile_image_px": [800, 800],
      "profile_image_format": "PNG",
      "cover_banner_format": ["SVG", "PNG @2x"],
      "watermark_color": "#FFFFFF",
      "watermark_max_opacity": 0.8,
      "preferred_chip_background": ["Mezzanotte", "Evenfan Blu"]
    },
    "favicon_app_icon": {
      "favicon_ico_sizes_px": [16, 32, 48],
      "apple_touch_icon_px": [180, 180],
      "android_adaptive_px": [108, 108],
      "android_adaptive_safe_zone_px": 66,
      "app_store_icon_px": [1024, 1024],
      "app_store_alpha_channel": false,
      "background": ["Mezzanotte", "Evenfan Blu"],
      "mark_color": "#FFFFFF"
    }
  },
  "file_naming": {
    "convention": "evenfan_<type>_<variant>[_su_<background>].<format>",
    "types": ["logo", "monogramma", "favicon", "app_icon", "brand_guidelines"],
    "variants": ["colori", "azzurro", "blu", "rosso", "bianco"],
    "backgrounds": ["bianco", "trasparente", "blu"],
    "formats": {
      "vector": ["svg", "eps", "pdf"],
      "raster": ["png"]
    },
    "impossible_combinations": [
      "blu_su_blu (no contrast)",
      "bianco_su_bianco (no contrast)"
    ]
  },
  "licensing": {
    "third_party_use": "allowed only under written agreement",
    "co_branding_approval": "must be reviewed by the Evenfan design team before any external publication"
  }
}
