Fylgja Tokens

Establish a consistent design language across your projects with Fylgja Design Tokens.

This predefined set of tokens eliminates redundant variations in spacing, colors, and other design elements, ensuring a unified structure throughout your codebase.

For projects with specific requirements, Fylgja offers granular imports.

Select only the necessary token categories, such as spacing, and define your own custom color palettes.

Furthermore, Fylgja seamlessly integrates with PostCSS Jit Props, mirroring the functionality of Open Props and other design token systems, for optimized CSS output.

Installation

You can install Fylgja Tokens via npm or other Node-based package managers like pnpm or bun:

npm install @fylgja/tokens

Alternatively, you can use it directly via a CDN:

<link href="https://cdn.jsdelivr.net/npm/@fylgja/tokens/css/index.min.css" rel="stylesheet">

Usage

Once installed, you can import the full package with:

import tokens from "@fylgja/tokens";

or as CSS with:

@import "@fylgja/tokens/css";

Next to this we also offers imports for SCSS, JS and for design systems in a json format.

Each option can be import for all tokens or just the part you need.

Shadow DOM Support

For web components utilizing Shadow DOM, import the .host variants to apply tokens within the host scope:

@import "@fylgja/tokens/aspect-ratio.host";

This enables seamless integration of Fylgja Design Tokens within your custom web components.

PostCSS Jit Props Integration

Leverage PostCSS Jit Props to optimize CSS output by including only the tokens used in your project.

While Fylgja tokens are designed for minimal size, this integration further reduces file sizes, especially when combined with custom tokens.

Previews

Aspect-Ratio

Border Radius

Conditional

Functions identically to the preceding numbered examples, except that this value reverts to 0 when the element’s boundaries intersect with the screen edges.

Border Sizes

Colors

Unlike other approaches where colors are predefined, we offer a dynamic color map. This map defines ranges of colors that can be modified using the --hue or --chroma variables.

This approach minimizes the amount of CSS required for color definitions. It simplifies color implementation by defining only the color strength (--color-{NUMBER}) and a --hue. We also provide a set of predefined hues for convenience.

Easing

Achieve smooth and natural animations with five robust timing functions: ease, ease-out, ease-in, and ease-in-out. Go beyond the basics with advanced easing options with the elastic motion.

Fonts

Easily customize your text with variable and static font sizes, intelligently adjusted line heights, modern font stacks, and a comprehensive set of typography variables.

Shadows

Sizes

Fylgja includes a comprehensive numeric spacing scale characterized by its proportional values. This ensures predictable and consistent spacing relationships within the design system.

--size-{1-10}
--size-{12,14,16,18,20,24,28,32,36}
--size-{40,50,60,70,80,90,100,120}
--size-heading
--size-content

Z-Layer

Z-indexes don’t need high values, just a currated list of values. If you need a higher z-index then your probley trying to override an exciting behavior and should consider refactoring the z-index values or wrap the z-indexes inside a new stacking layer.