brand.config.json

Generated by nib brand init and stored at .nib/brand.config.json. Controls paths, platform outputs, and AI provider settings for the brand system.

Schema

{
  "version": "1",
  "generator": "nib",
  "brand": {
    "name": "Acme Corp",
    "personality": ["professional", "warm"]
  },
  "tokens": "docs/design/system/tokens",
  "platforms": {
    "css": "docs/design/system/build/css/variables.css",
    "tailwind": "docs/design/system/build/tailwind/preset.js",
    "pencil": "docs/design/system/build/pencil/variables.json"
  },
  "output": "docs/design/system",
  "ai": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514"
  }
}

Fields

Field	Type	Description
version	"1"	Config format version
generator	"nib"	Always "nib"
brand.name	string	Brand name
brand.personality	string[]	Personality traits (e.g. "professional", "warm", "bold")
tokens	string	Path to the DTCG token source directory
platforms	object	Paths to platform-specific build outputs
platforms.css	string	CSS custom properties file
platforms.tailwind	string	Tailwind preset file
platforms.pencil	string	Pencil.dev variables JSON
output	string	Root output directory for the design system
ai.provider	string	AI provider used during init: "anthropic", "openai", "ollama"
ai.model	string	Model used (optional)

Environment Variables

Variable	Description
NIB_AI_PROVIDER	Override AI provider (same values as --ai flag)
ANTHROPIC_API_KEY	Anthropic API key for brand enhancement
OPENAI_API_KEY	OpenAI API key for brand enhancement
NIB_AI_BASE_URL	Base URL for Ollama or any OpenAI-compatible endpoint

Notes

• This file is auto-generated — edit it to change paths or provider settings
• The tokens path points to the source of truth (DTCG JSON files)
• The platforms paths point to generated outputs — rebuilding with nib brand build overwrites them
• All paths are relative to the project root