{"_id":"@aios-alpha/design","_rev":"9-11986ad8da58818423a13e211788dab0","name":"@aios-alpha/design","dist-tags":{"latest":"0.6.0"},"versions":{"0.1.0":{"name":"@aios-alpha/design","version":"0.1.0","license":"MIT","_id":"@aios-alpha/design@0.1.0","maintainers":[{"name":"iamjohndass","email":"iamjohndass@pm.me"}],"dist":{"shasum":"445ea33c90e44c64d8675844aff0d83800f51497","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.1.0.tgz","fileCount":13,"integrity":"sha512-/fTY0ug9k7XCBhWfUWDoEzQZ0ScfW3pWydSzJlO8hr83LUbANHeUCuNB7/U3rZqDLD4ml6cw/Vt9+JZlu5PN9A==","signatures":[{"sig":"MEUCIEKDJ3kpLXh1MSY3tq3gjUzlnx1nxwilqMMHZvc+Ii01AiEAtWzJ1xZqekfHr6UZEY1NdkC2H9C+Ok1wLJ90RWB0MPM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37215},"type":"module","exports":{"./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"scripts":{"build:tokens":"node build/build.mjs"},"_npmUser":{"name":"iamjohndass","email":"iamjohndass@pm.me"},"_npmVersion":"10.9.4","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, and Pencil variables. Single source of truth for every AIOS surface.","directories":{},"_nodeVersion":"22.21.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"style-dictionary":"^4.3.0"},"_npmOperationalInternal":{"tmp":"tmp/design_0.1.0_1782138935176_0.05142392426910636","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@aios-alpha/design","version":"0.2.1","license":"MIT","_id":"@aios-alpha/design@0.2.1","maintainers":[{"name":"iamjohndass","email":"iamjohndass@pm.me"}],"homepage":"https://github.com/AIOS-alpha/aios-design#readme","bugs":{"url":"https://github.com/AIOS-alpha/aios-design/issues"},"dist":{"shasum":"df1e81b5666731584d903ee80f6b2ee1b6145e61","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.2.1.tgz","fileCount":13,"integrity":"sha512-BljGQdicgNqp9BNggoCFDolwSD+Q6r4KBAMDqEqfXxd2HLYP0rT2+ManlCoG+JK4RChCvg1bF1/GeGPgSQ5P2Q==","signatures":[{"sig":"MEYCIQCS4D2swEtCgPEajUD8jInP+EDHGtSj/UTsoEdPfXo+ewIhAMkQ0NA237merj7t4+9KoGFUGXcj3VymBMtAhdvxTtw6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":31741},"type":"module","exports":{"./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"434b7e94a0324ab418f874d048b03cc78e8df2c5","scripts":{"prepare":"npm run build:tokens","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:36a37ee8-8316-4a32-baac-ef7189c56fe7"}},"repository":{"url":"git+https://github.com/AIOS-alpha/aios-design.git","type":"git"},"_npmVersion":"11.17.0","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, and Pencil variables. Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges and data viz.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"style-dictionary":"^4.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/design_0.2.1_1782206350684_0.8212900857597663","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@aios-alpha/design","version":"0.3.0","license":"MIT","_id":"@aios-alpha/design@0.3.0","maintainers":[{"name":"iamjohndass","email":"iamjohndass@pm.me"}],"homepage":"https://github.com/AIOS-alpha/aios-design#readme","bugs":{"url":"https://github.com/AIOS-alpha/aios-design/issues"},"dist":{"shasum":"597ab8096416bf38829bae9d96f583edd9cd82a1","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.3.0.tgz","fileCount":13,"integrity":"sha512-EfOL11d/5VUbpdjPxXOXbChC3mxUVX5qfO+J6faYNBLJPORps8YyQwfLraAg00SLqVi1voS7gtqPcYutXRkGKw==","signatures":[{"sig":"MEQCIFppwaTjIAYgmsjZl4AqVb2h4Vgd6x2emjuEeBfr1QhmAiBRNQEnbRS++lMXP4Gc2hXAycBe+EVTxNV7/vK5Q+qtfw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":36743},"type":"module","exports":{"./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"335fac539f610055abf332a73e2bf783085cb5a9","scripts":{"prepare":"npm run build:tokens","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:36a37ee8-8316-4a32-baac-ef7189c56fe7"}},"repository":{"url":"git+https://github.com/AIOS-alpha/aios-design.git","type":"git"},"_npmVersion":"11.17.0","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, and Pencil variables. Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges and data viz.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"style-dictionary":"^4.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/design_0.3.0_1782274057915_0.6013869508154333","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@aios-alpha/design","version":"0.3.1","license":"MIT","_id":"@aios-alpha/design@0.3.1","maintainers":[{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-design#readme","bugs":{"url":"https://github.com/aiosbrain/aios-design/issues"},"dist":{"shasum":"4b520dfff34237f3b498d96113dbc5c56b010eb3","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.3.1.tgz","fileCount":13,"integrity":"sha512-1X8fxiKfrojj7D6LxF/fHAMmbaIipWrzvqc+wbeje/Xs9cDrH18CjdDC6VSDnECCNorW3wVqWb2w4HfuZYV7AA==","signatures":[{"sig":"MEQCICDJL40kQ4os7EzFl4UJ8oBZpXCzSTD2wSFiyChVuORrAiAHRJjdcO3ZsC7rGuEgucoWYrV78vzldGaLg4MGyTJOqQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":39497},"type":"module","exports":{"./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"b41f603e7ec9ed6a3d1a094ace492d00b02cc44e","scripts":{"test":"npm run build:tokens && node --test test/design-contract.test.mjs","prepare":"npm run build:tokens","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:bfddab72-9c0a-4b64-b781-759e50450777"}},"repository":{"url":"git+https://github.com/aiosbrain/aios-design.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, and Pencil variables. Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges and data viz.","directories":{},"_nodeVersion":"22.23.2","dependencies":{},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"style-dictionary":"^5.4.4"},"_npmOperationalInternal":{"tmp":"tmp/design_0.3.1_1786961990005_0.7914374731629714","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@aios-alpha/design","version":"0.4.0","license":"MIT","_id":"@aios-alpha/design@0.4.0","maintainers":[{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-design#readme","bugs":{"url":"https://github.com/aiosbrain/aios-design/issues"},"dist":{"shasum":"0519c94ff923fec23e9012571419d9030bb600c1","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.4.0.tgz","fileCount":30,"integrity":"sha512-6VHRtqhvWoLWpD9bDpsKZM3tHz4zjtILp7GiUk/JKchI4GEAs4XlgMmbIJICrEg8tcCkQZxex8S4atMmxDt4jA==","signatures":[{"sig":"MEYCIQCB7eRXucaeP+hUcGzOtSLxsCh/bwiknrnix18RUOHPfwIhAO3iouwrd1rrJoQRsVkFcX1BL2u+2RCsZq7osllrtEvV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":269201},"type":"module","exports":{"./brand/*":"./dist/brand/*","./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"fde0e01e52c27ad3cfe4e34edaf69d2deb9d28b2","scripts":{"test":"npm run build && node --test test/design-contract.test.mjs","build":"npm run build:tokens && npm run build:brand","prepare":"npm run build","build:brand":"node build/build-brand.mjs","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:bfddab72-9c0a-4b64-b781-759e50450777"}},"repository":{"url":"git+https://github.com/aiosbrain/aios-design.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, Pencil variables, and the canonical brand assets (caret-A mark, wordmark, lockups). Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges","directories":{},"_nodeVersion":"22.23.2","dependencies":{},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"style-dictionary":"^5.4.4"},"_npmOperationalInternal":{"tmp":"tmp/design_0.4.0_1787056536166_0.48212732382306234","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@aios-alpha/design","version":"0.5.0","license":"MIT","_id":"@aios-alpha/design@0.5.0","maintainers":[{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-design#readme","bugs":{"url":"https://github.com/aiosbrain/aios-design/issues"},"dist":{"shasum":"b12dfb1aa7bc37fc6cc7ad6c686811f47d30ac7c","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.5.0.tgz","fileCount":34,"integrity":"sha512-FP4Ukg/1Q1VJVH0PuB+Wv6M5WtqPmSpaLixXvfCh7yJDUjo6M1aRjrqWYm0p/UcczkVxzYBkiDTkqxjlMlo9Zg==","signatures":[{"sig":"MEQCIDl5s++qVJtiYV6pr18V5nOpzJxxadcBRvS+yw/+KgwQAiA58LTdhDhg3qt/4VQoH7xbCdGqH/z5wGpXy9vDMmywiQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":340660},"type":"module","exports":{"./brand/*":"./dist/brand/*","./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"a7aa10b78750bbdd1bac6ed1b1fa5a5f2bf95a15","scripts":{"test":"npm run build && node --test test/design-contract.test.mjs","build":"npm run build:tokens && npm run build:brand","prepare":"npm run build","build:brand":"node build/build-brand.mjs","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:bfddab72-9c0a-4b64-b781-759e50450777"}},"repository":{"url":"git+https://github.com/aiosbrain/aios-design.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, Pencil variables, and the canonical brand assets (caret-A mark, wordmark, lockups). Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges","directories":{},"_nodeVersion":"22.23.2","dependencies":{},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"style-dictionary":"^5.4.4"},"_npmOperationalInternal":{"tmp":"tmp/design_0.5.0_1787065946799_0.34463559633991836","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@aios-alpha/design","version":"1.0.0","license":"Apache-2.0","_id":"@aios-alpha/design@1.0.0","maintainers":[{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-design#readme","bugs":{"url":"https://github.com/aiosbrain/aios-design/issues"},"dist":{"shasum":"fa2d81d46f8277330c404b60f8b165b366f7f69f","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-1.0.0.tgz","fileCount":35,"integrity":"sha512-6q+NVyQQeUvEUkOAJpKUwf2Qezp6pmvXxsIv0Vt9zy8pNwc1T238frTGSo9RwDRAjfZDysueeJITsJFEtXTi9g==","signatures":[{"sig":"MEUCIAHPpgenhTsJjSXM02w15Q+IeS7ranHzZkK/I6OVAxsqAiEAmgCaadrvLRdP/gXeGmVuEBQshWSOU3re3QZ7PorDcsQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":353080},"type":"module","exports":{"./brand/*":"./dist/brand/*","./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"55d7bc2a74384c6581b92d9d9027757882e8fddf","scripts":{"test":"npm run build && node --test test/design-contract.test.mjs","build":"npm run build:tokens && npm run build:brand","prepare":"npm run build","build:brand":"node build/build-brand.mjs","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:bfddab72-9c0a-4b64-b781-759e50450777"}},"repository":{"url":"git+https://github.com/aiosbrain/aios-design.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, Pencil variables, and the canonical brand assets (caret-A mark, wordmark, lockups). Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges","directories":{},"_nodeVersion":"22.23.2","dependencies":{},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"style-dictionary":"^5.4.4"},"_npmOperationalInternal":{"tmp":"tmp/design_1.0.0_1787081455802_0.6848109052150746","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Premature major: this was the Apache-2.0 relicense, not an API break. Use ^0.6.0."},"0.6.0":{"name":"@aios-alpha/design","version":"0.6.0","license":"Apache-2.0","_id":"@aios-alpha/design@0.6.0","maintainers":[{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-design#readme","bugs":{"url":"https://github.com/aiosbrain/aios-design/issues"},"dist":{"shasum":"4099b6f142314ad0f689d001e02662ff140f6b78","tarball":"https://registry.npmjs.org/@aios-alpha/design/-/design-0.6.0.tgz","fileCount":35,"integrity":"sha512-ifgviabyphh8/N8bmbUbx8Nen6wknmUiFiiewD9678vMvweLhfnhfzvHM9NvroYuhiMkGz4wEwdGgHoHO8mD+w==","signatures":[{"sig":"MEYCIQCQQA9f5agucD3PrpZRabLCDtIRyiUF2nRxIfIyX2R5QQIhALbEq9SqMAbFL4XSRy3IxmnQ5d24nOGfKTkRbZ/ao8tD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aios-alpha%2fdesign@0.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":353091},"type":"module","exports":{"./brand/*":"./dist/brand/*","./DESIGN.md":"./DESIGN.md","./tokens.css":"./dist/tokens.css","./tailwind-theme.css":"./dist/tailwind-theme.css","./tokens.pencil.json":"./dist/tokens.pencil.json"},"gitHead":"7142d763a5c3481b3c822123d6985e04144de5f6","scripts":{"test":"npm run build && node --test test/design-contract.test.mjs","build":"npm run build:tokens && npm run build:brand","prepare":"npm run build","build:brand":"node build/build-brand.mjs","build:tokens":"node build/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:bfddab72-9c0a-4b64-b781-759e50450777"}},"repository":{"url":"git+https://github.com/aiosbrain/aios-design.git","type":"git"},"_npmVersion":"11.5.1","description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, Pencil variables, and the canonical brand assets (caret-A mark, wordmark, lockups). Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges","directories":{},"_nodeVersion":"22.23.2","dependencies":{},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"style-dictionary":"^5.4.4"},"_npmOperationalInternal":{"tmp":"tmp/design_0.6.0_1787129884604_0.3294272733505843","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-06-22T14:35:35.035Z","modified":"2026-08-20T08:25:52.774Z","0.1.0":"2026-06-22T14:35:35.324Z","0.2.1":"2026-06-23T09:19:11.081Z","0.3.0":"2026-06-24T04:07:38.046Z","0.3.1":"2026-08-17T10:19:50.141Z","0.4.0":"2026-08-18T12:35:36.533Z","0.5.0":"2026-08-18T15:12:26.944Z","1.0.0":"2026-08-18T19:30:55.958Z","0.6.0":"2026-08-19T08:58:04.750Z"},"bugs":{"url":"https://github.com/aiosbrain/aios-design/issues"},"license":"Apache-2.0","homepage":"https://github.com/aiosbrain/aios-design#readme","repository":{"url":"git+https://github.com/aiosbrain/aios-design.git","type":"git"},"description":"AIOS unified design system — DTCG tokens, CSS variables, Tailwind v4 theme, Pencil variables, and the canonical brand assets (caret-A mark, wordmark, lockups). Editorial Minimal direction: greyscale chrome, Instrument typography, colour rationed to badges","maintainers":[{"name":"iamjohndass","email":"john@john-ellison.com"}],"readme":"# @aios-alpha/design\n\nThe one design system for every AIOS surface — website, team brain, workspace GUI, and every scaffolded workspace. **Editorial Minimal** direction: dual-mode, greyscale chrome, Instrument typography, colour rationed to badges and data viz.\n\n| Package | What it ships |\n|---------|---------------|\n| **`@aios-alpha/design`** (this repo root) | DTCG tokens → `dist/tokens.css`, `dist/tailwind-theme.css`, the brand assets → `dist/brand/*.svg`, and `DESIGN.md` |\n| **`@aios-alpha/ui`** (`react/`) | shadcn-based React components themed through the token bridge |\n\n- **`DESIGN.md`** — pinned design contract (like `brain-api.md` for sync). Read this before building UI.\n- **`tokens/*.json`** — DTCG source of truth. Edit here, then rebuild.\n- **`brand/src/*.json`** — logo geometry source of truth. The one AIOS logo lives here; see `DESIGN.md` § Brand & Logo.\n- **`dist/`** — generated by `npm run build` (`build:tokens` + `build:brand`); gitignored, CI rebuilds before publish.\n\n## Prerequisites\n\n- **Node** — for the token + React build below.\n- **[Git LFS](https://git-lfs.com)** — the Pencil design source (`aios-design.pen`, a ~2 MB binary) is tracked via Git LFS, **not** plain git. Install it **once per machine before cloning** so the file materializes instead of leaving a small text pointer:\n\n  ```bash\n  git lfs install                                       # once per machine\n  git clone git@github.com:AIOS-alpha/aios-design.git\n  ```\n\n  Already cloned before installing LFS? Run `git lfs install && git lfs pull`. See [`PENCIL.md`](./PENCIL.md) for opening the file.\n\n## Build\n\n```bash\nnpm install\nnpm run build            # regenerates dist/ (tokens + brand assets)\n\ncd react && npm install && npm run build   # compiles @aios-alpha/ui to react/dist/\n```\n\n## Consume in another repo\n\nInstall the Design contract patch with the compatible UI package:\n\n```bash\nnpm install @aios-alpha/design@^0.6.0 @aios-alpha/ui@^0.6.0\n```\n\n**Tailwind v4 app** — global stylesheet, **in this order**:\n\n```css\n@import \"@aios-alpha/design/tokens.css\";\n@import \"@aios-alpha/design/tailwind-theme.css\";\n@import \"tailwindcss\";\n@source \"../node_modules/@aios-alpha/ui/dist\";\n@custom-variant dark (&:where(.dark, .dark *));\n```\n\nSelf-host fonts (no Google CDN):\n\n```css\n@import \"@fontsource/instrument-serif/400.css\";\n@import \"@fontsource/instrument-sans/400.css\";\n@import \"@fontsource/instrument-sans/500.css\";\n@import \"@fontsource/instrument-sans/600.css\";\n@import \"@fontsource/instrument-sans/700.css\";\n@import \"@fontsource/jetbrains-mono/400.css\";\n```\n\nThen use bridge utilities (`bg-background`, `text-foreground`, `bg-primary`, `text-violet`, `font-display`, `rounded-full`, …). Toggle dark mode with `class=\"dark\"` on `<html>`.\n\n**React components:**\n\n```tsx\nimport { Button, TierBadge, AiosLogo, AiosMark, KpiStat } from \"@aios-alpha/ui\";\n```\n\n**Brand assets** — one monochrome logo, shipped as files for non-React surfaces:\n\n```css\n/* currentColor: inherits ink, flips with the theme. Inline it or use it as a mask. */\n.logo { mask: url(\"@aios-alpha/design/brand/aios-lockup.svg\") center / contain no-repeat; }\n```\n\n`aios-lockup.svg` (default) · `aios-lockup-stacked.svg` · `aios-mark.svg` · `aios-wordmark.svg`,\neach also as `-black.svg` / `-white.svg` for `<img>`, print, and video where `currentColor` cannot\nresolve. `aios-mark-prism.svg` is the gradient mark (≥48px), and `aios-lockup-display-white.svg` /\n`-black.svg` (plus the stacked pair) put that gradient mark beside a single-ink wordmark — **brand\nartwork only** (social cards, covers, decks, merch, video), never product UI. Read `DESIGN.md`\n§ Brand & Logo before using any of them.\n\n**Astro / Starlight** — import `tokens.css` and map `--aios-*` onto Starlight's `--sl-*` (see `aios-website`).\n\n**Raw CSS (no Tailwind)** — import `tokens.css` and use `var(--aios-*)` directly.\n\n### Semantic tokens (0.5.0 contract; unchanged 0.3.0 token values)\n\n| Token | Use for |\n|-------|---------|\n| `--aios-primary` | Pill buttons, active tabs (near-black light / white dark) |\n| `--aios-violet` | Brand mark, team/deliverable badges, link accents |\n| `--aios-accent` | Lime — live status, checks, rationed affirmative actions |\n| `--aios-emerald/amber/cyan/fuchsia` | Kind/tier badges, KPI sparklines |\n\n0.3.0 also adds a per-mode effects layer — card-glow shadows (`--aios-shadow-glow-card*` / `-featured*`) and liquid-glass tokens (`--aios-glass-*`, `--aios-blur-glass*`) — see the \"0.3.0 — Effects layer\" section in `DESIGN.md`.\n\n0.3.1 does not change token values. It aligns both `@aios-alpha/design` and `@aios-alpha/ui` with\nthe packaged contract version, makes the UI ESM entry directly importable by Node, and narrows the\nconsumer-colour exception policy.\n\n### Upgrading from 0.3.x — one visual breaking change\n\nToken values, CSS variables, and the Tailwind bridge are **unchanged** across 0.4.0 and 0.5.0, so\na stylesheet-only consumer upgrades with no work. The one break is in `@aios-alpha/ui`:\n\n- **`AiosMark` flipped its default in 0.4.0.** It used to render the prism gradient; it now renders\n  `currentColor`. Pass `prism` to get the gradient back. The old `mono` prop is accepted and\n  ignored, so `<AiosMark mono />` still renders correctly — but a bare `<AiosMark />` that used to\n  be colourful is now monochrome. **This changes rendered output without a type error**, so it will\n  not show up in a typecheck; look at the screen.\n- If you were loading `aios-mark-mono.svg` from a consuming repo's own assets, the canonical\n  equivalent is `@aios-alpha/design/brand/aios-mark.svg` (`currentColor`) or `aios-mark-white.svg`.\n\nIf that monochrome mark is wrong for your surface, you are probably rendering brand artwork rather\nthan UI — see the display lockup above.\n\n0.6.0 does not change token values, CSS variables, the Tailwind bridge, brand assets, or any\ncomponent API. It relicenses the packages from MIT to Apache-2.0 and ships as a major version for\nthat reason alone — see [`CHANGELOG.md`](CHANGELOG.md) and [`LICENSING.md`](LICENSING.md).\nUpgrading from 0.5.0 is a version-string change and nothing else.\n\n0.5.0 does not change token values. It splits the logo rule by context: product UI and chrome stay\nstrictly monochrome, while brand artwork may use the new **display lockup** (prism mark + single-ink\nwordmark). The wordmark is never coloured in either context. See \"0.5.0 — UI vs brand artwork\" in\n`DESIGN.md`.\n\n0.4.0 does not change token values either. It gives the design system ownership of the logo:\none monochrome lockup, published as `@aios-alpha/design/brand/*` and as `AiosLogo` in\n`@aios-alpha/ui`, replacing the six inconsistent marks that were in circulation. The prism\ngradient is now bare-mark-only. See \"0.4.0 — Brand & logo contract\" in `DESIGN.md`.\n\n### Migrating from 0.1.x\n\n- **Fonts:** Space Grotesk + Plus Jakarta Sans → Instrument Serif + Instrument Sans.\n- **Buttons:** violet glow pills → near-black/white editorial pills (`primary` token changed).\n- **Badges:** team/deliverable now use `violet` token, not `primary`.\n- **Local CSS bridges:** if you alias `--accent` to `--aios-primary`, split — buttons stay on `primary`, link/highlight washes move to `--aios-violet`.\n\n## Light vs dark\n\nLight is `:root`. `class=\"dark\"` on `<html>` swaps color values; type, spacing, and radius are mode-independent.\n\n## Pencil prototyping\n\n`dist/tokens.pencil.json` holds flat token maps for the Pencil MCP `set_variables` call. See `PENCIL.md`.\n\n## License\n\n**Apache-2.0** — see [`LICENSE`](LICENSE) and [`LICENSING.md`](LICENSING.md).\n\nPermissive on purpose. This is meant to be embedded in your interfaces, including\ncommercial and closed-source ones. Keep the license and copyright notices, state what you\nchanged, and it's yours to use.\n\nVersions published at `0.5.0` and earlier were MIT and **remain MIT** — see\n[`LICENSE-MIT`](LICENSE-MIT) and [`CHANGELOG.md`](CHANGELOG.md). The relicense is\ngoing-forward only, and it ships as a major version precisely so it isn't a surprise.\n\nThe AIOS server is AGPL-3.0 while this is Apache-2.0; that split is deliberate, and\n`LICENSING.md` explains it.\n","readmeFilename":"README.md"}