@frame-kit/tokens 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FrameKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @frame-kit/tokens
+
+The default **design tokens** (CSS custom properties) and **dark theme** for
+[`@frame-kit/ui-ng`](https://www.npmjs.com/package/@frame-kit/ui-ng). Ship the neutral baseline as-is,
+or override any `--fk-*` token to rebrand the whole component library.
+
+## Install
+
+```bash
+npm i @frame-kit/tokens
+```
+
+## Usage
+
+Load the CSS in `angular.json` → `styles` (or any global stylesheet), **before** your own overrides:
+
+```jsonc
+"styles": [
+  "node_modules/@frame-kit/tokens/base.css", // default neutral theme
+  "node_modules/@frame-kit/tokens/dark.css", // optional — activates on prefers-color-scheme or html.dark
+  "src/styles.css" // YOUR overrides last → cascade wins
+]
+```
+
+Override tokens anywhere downstream:
+
+```css
+:root {
+  --fk-color-primary: #7c3aed; /* sweeping brand change */
+  --fk-radius-md: 4px;
+}
+```
+
+Also available:
+
+- `@frame-kit/tokens/scss` — the source SCSS (base) for SCSS consumers; `@frame-kit/tokens/scss/dark` for dark.
+- A typed token object: `import { tokens } from '@frame-kit/tokens'` (`Record<FkTokenName, string>`).
+
+See the **[theming guide](https://github.com/frame-kit/packages/blob/main/packages/ui-ng/THEMING.md)** for the full
+token contract and override recipes.
+
+## License
+
+MIT