feat(deps): declare brand as an optional peer dependency

CHANGELOG.md

@@ -5,6 +5,10 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### Added
+
+- **Peer dependency**: `@behindthemusictree/brand` (`^12.0.0`) is now declared as an optional peer dependency, making the existing reliance on its CSS variables explicit. The README lists the variables read.
+
 ## [0.1.0] - 2026-08-14
 
 ### Added

README.md

@@ -20,6 +20,9 @@ on this package rather than the other way around.
 Components are styled with Tailwind utility classes referencing CSS custom properties
 (`--color-*`, `--space-*`, `--radius-*`). **Consumers must also load
 `@behindthemusictree/brand`'s `tokens/theme.css`** — this package does not ship or import it.
+`brand` is an optional peer dependency (`^12.0.0`): the app installs and owns its version. Outside
+BTMT, define the variables yourself instead; the ones currently read are `--color-primary`,
+`--color-neutral-{100,200,300,700}`, `--color-red-{600,700}` and `--color-green-600`.
 
 ## Development
 

packages/ui/package.json

@@ -31,7 +31,13 @@
   },
   "peerDependencies": {
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "@behindthemusictree/brand": "^12.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@behindthemusictree/brand": {
+      "optional": true
+    }
   },
   "dependencies": {
     "class-variance-authority": "^0.7.1",
@@ -41,6 +47,7 @@
     "tailwind-merge": "^3.2.0"
   },
   "devDependencies": {
+    "@behindthemusictree/brand": "^12.0.0",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "react": "^18.2.0",