Fabric CSS

This is the core package for Fabric CSS, FINNs design system.

The package includes resets, core components and Tailwind utility classes tuned for FINN.

Usage (preferred)

The CSS should be used directly from Eik. This is because we can alias releases by major versions.

<link href="https://assets.finn.no/pkg/@fabric-ds/css/v1/fabric.min.css" rel="stylesheet" />

Usage (npm)

npm install @fabric-ds/css

Development

Install dependencies:

npm install

Start a dev server:

npm run dev

Changes to to either the CSS, Tailwind configuration or the HTML files should hot reload.

We use commitizen to ensure coherent commit message structure, used by semantic release to generate change logs and handle versioning.

npm install -g commitizen

When installed, you should be able to type cz or git cz in your terminal to commit your changes (replacing git commit).

Releases

This project uses Semantic Release to automate package publishing when making changes to the main or next branch.

It is recommended to branch off the next branch and follow conventional commits when making changes. When your changes are ready for pull request, this should be opened against the next branch.

Read more in-depth about Fabric Releases here.

Please note that the version published will depend on your commit message structure. Make sure to use commitizen (see Development section).