Welcome to @warp-ds/elements, a collection of Web Components built with Lit to be used to build interfaces based on the Warp Design System. This repository is maintained by the Warp Core Team and is home to the @warp-ds/elements library.
If you'd like to contribute to @warp-ds/elements
,
start by reviewing the contributing guidelines.
Install by using npm/pnpm or by adding a script link:
npm install @warp-ds/elements
pnpm add @warp-ds/elements
<script src="https://assets.finn.no/pkg/@warp-ds/elements/v1"></script>
This project builds both the whole Elements package and separate component packages that are published to EIK, making it possible for the user to choose to either import all of the components:
import '@warp-ds/elements';
or a specific component:
import '@warp-ds/elements/components/toast';
For information on the components available in the package and how to use them, see the Warp Design System documentation.
This project is continuously published to NPM and Eik using a next
tag (e.g. 1.1.0-next.1
).
Anyone needing to use the latest changes of this package can point to the next
version while waiting for the stable release.
Detailed changes for each release can be found in the CHANGELOG file.
It is possible to test changes that have been made to component-classes from the @warp-ds/css package but that has not yet been published to Eik. You simply need to link the @warp-ds/css
package in this repository and add @unocss-placeholder
inside the static styles of the component that you want to test:
static styles = [
css`
@unocss-placeholder
`,
]
Run pnpm dev
to see the linked styles in action.
Once you have tested it locally, make sure to remove the @unocss-placeholder
from the static styles before pushing any changes to the repository.
@warp-ds/elements is available under the Apache-2.0 software license.