@beonit/adaptive-raindrop-tokens
v0.3.0
Published
Adaptive Raindrop design tokens & foundations as framework-agnostic CSS. Brand/platform/tenant tokens, shadcn token layer, Avenir Next fonts and typographic utilities.
Maintainers
Readme
@beonit/adaptive-raindrop-tokens
Visual foundations of Adaptive Raindrop as framework-agnostic CSS: brand/platform/tenant tokens, the shadcn token layer, the Avenir Next fonts and the typographic utilities.
It is the shared aesthetic source of truth. Any consuming app (Vue, React, etc.) consumes the same tokens, so the whole ecosystem shares one visual language without duplicating values. Adaptive Raindrop sits above the products: no product defines the system.
To migrate a React frontend to Adaptive Raindrop, read PORTING_GUIDE.md. For the normative interface rules every product must follow, read RULES.md. For the platform copilot (Sara) rules, read COPILOT.md.
What's included
src/
├── index.css All-in-one entry (Tailwind v4).
├── tokens.css :root brand/platform/tenant variables (agnostic).
├── shadcn-tokens.css :root + .dark shadcn variables (agnostic).
├── theme.css @theme inline + @custom-variant + @layer base (Tailwind v4).
├── base.css @font-face Avenir Next + body reset + .t-* utilities.
└── assets/
└── fonts/avenir-next/{400,600,700}.woff2Installation
Option A — Direct from Git (no registry)
Requires read access to the package repo.
// consumer package.json
"dependencies": {
"@beonit/adaptive-raindrop-tokens": "git+https://github.com/<org>/adaptive-raindrop.git#v0.1.0"
}Option B — GitHub Packages (private registry)
- Copy
.npmrc.exampleto.npmrcin your project and set a token with theread:packagesscope. - Install:
npm install @beonit/adaptive-raindrop-tokensUsage
With Tailwind v4 (recommended)
In your root CSS, import the package after Tailwind:
@import "tailwindcss";
@import "@beonit/adaptive-raindrop-tokens";You get:
- CSS variables (
--p-primary,--c-ink,--background, …). - Tailwind utilities:
bg-p-primary,text-mute,shadow-card,bg-background,text-foreground,border-border,bg-sidebar, … dark:bound to the.darkclass on an ancestor.- Avenir Next fonts and the
.t-h1,.t-body,.brand-fill, … utilities.
Without Tailwind
@import "@beonit/adaptive-raindrop-tokens/tokens";
@import "@beonit/adaptive-raindrop-tokens/shadcn";
@import "@beonit/adaptive-raindrop-tokens/base";And consume the variables directly:
.cta { background: var(--p-primary); color: var(--p-primary-ink); }Dark mode
Add the dark class to an ancestor (typically <html> or <body>):
<html class="dark">Versioning
SemVer via git tags (v0.1.0, v0.2.0, …). Changes to token values are
minor; renaming/removing tokens is major.
