Tokens

Every token in a xtyle definition is optional and typed. This page documents the full token surface across all three pillars.

Visual Tokens

Colors

{
  "visual": {
    "colors": {
      "palette": { "crimson": "#DC143C", "cream": "#FFFDD0" },
      "semantic": { "primary": "crimson", "surface": "cream" },
      "contrast": { "primary-on-surface": "AAA" }
    }
  }
}

• palette — Named color definitions. Values are CSS color strings.
• semantic — Semantic mappings. Values reference palette names or are CSS color strings.
• contrast — Accessibility contrast rules.

Typography

{
  "visual": {
    "typography": {
      "families": { "heading": "Oswald", "body": "Source Sans Pro" },
      "scale": { "base": "16px", "ratio": 1.25 },
      "weights": { "regular": 400, "bold": 700 },
      "lineHeights": { "tight": 1.2, "normal": 1.6 }
    }
  }
}

Spacing

{
  "visual": {
    "spacing": {
      "scale": { "xs": "0.25rem", "sm": "0.5rem", "md": "1rem", "lg": "2rem" },
      "grid": { "columns": 12, "gutter": "1.5rem", "margin": "2rem" }
    }
  }
}

Layout

{
  "visual": {
    "layout": {
      "borderRadius": { "sm": "0.25rem", "md": "0.5rem", "full": "9999px" },
      "shadows": { "sm": "0 1px 2px rgba(0,0,0,0.1)" },
      "elevation": { "modal": 100, "tooltip": 200 },
      "breakpoints": { "sm": "640px", "md": "768px", "lg": "1024px" }
    }
  }
}

Verbal Tokens

Identity

{
  "verbal": {
    "identity": {
      "name": "Crossfield Cricket Club",
      "tagline": "Gentlemen don't sledge. Usually.",
      "description.short": "Community cricket in south Manchester.",
      "description.long": "A longer description...",
      "elevator": "One-sentence pitch."
    }
  }
}

Jargon

{
  "verbal": {
    "jargon": {
      "sledge": "Verbal gamesmanship. Frowned upon. Mostly.",
      "nightwatchman": "A lower-order batter sent in to protect a better one."
    }
  }
}

Copy Library

{
  "verbal": {
    "copy": {
      "welcome": "Welcome to the crease.",
      "cta-signup": { "text": "Join the club", "version": "2.0" }
    }
  }
}

Voice Tokens

Voice tokens are structured guidance — they maximize fidelity without promising mechanical reproduction.

{
  "voice": {
    "tone": { "energy": "dry wit, understated", "formality": "casual-leaning" },
    "values": { "principles": ["fair play", "community first"] },
    "positioning": {
      "is": "a local club that takes the game seriously and itself not at all",
      "isNot": "a competitive academy or a brand exercise"
    },
    "antiPatterns": ["corporate speak", "forced enthusiasm", "buzzwords"]
  }
}