KoliBri - Themes

The Themes module contains numerous themes (style guides) for the component library. They can be loaded in combination with the Components module.

You can read more about modularization in the architecture concept.

More about the project can be found in the documentation.

Installation

You can install the KoliBri themes with npm, pnpm or yarn:

npm i @public-ui/themes
pnpm i @public-ui/themes
yarn add @public-ui/themes

Usage

Register the themes like this:

import { register } from '@public-ui/components';
import { defineCustomElements } from '@public-ui/components/loader';
import { DEFAULT, ECL_EC, ECL_EU } from '@public-ui/themes';

register(
	DEFAULT,
	// or provide an array to register multiple themes:
	// [DEFAULT, ECL_EC, ECL_EU]
	defineCustomElements,
)
	.then(() => {
		/* KoliBri ready */
	})
	.catch((error) => {
		/* Handle errors */
	});

Override theme tokens in your own stylesheet as needed. The default theme README lists all available variables.

Important settings

Usage of pnpm

We use pnpm as package manager and there is a tiny typing issue with the default typescript setup.

What do we know?

This seems to be a general issue:

• https://github.com/microsoft/TypeScript/issues/29221
• https://github.com/microsoft/TypeScript/issues/48212

Solution:

We must activate the specific option preserveSymlinks in the tsconfig.json file.

  ...
  "preserveSymlinks": true,
  ...