Welcome to @warp-ds/react, a collection of React components for building user interfaces based on the Warp Design System. This repository is maintained by the Warp Core Team and is home to the @warp-ds/react library.
If you'd like to contribute to @warp-ds/react, start by reviewing the contributing guidelines.
Install by using npm/pnpm or by adding a script link:
npm install @warp-ds/reactpnpm add @warp-ds/react<script src="https://assets.finn.no/pkg/@warp-ds/react/v2"></script>This app contains 2 types of tests:
- Unit tests: These are based on vitest and testing-library. Run these tests in watch mode using
pnpm test:watchor with coverage report bypnpm test:unit. - Component tests: These are currently written with storybook. You can start storybook using
pnpm devand see the tests in the interavtive panel for a story. Alternatively, you can run these tests on CI/Command line usingpnpm test:storybook. This will start storybook and run tests concurrently. Note: you might have to runpnpm exec playwright installfirst time as you might not have the chromium playwright executable available locally.
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.
Currently Crowdin has a bug that makes the synchronize-with-crowdin build step fail in the next-branch. Crowdin does some extra pre-processing of uploaded files, and their processor breaks with obsolete strings syntax in the .po-files.
A temporary fix to this is to run
pnpm lingui extract --cleanThis command should no longer be necessary to run once the bug in Crowdin is fixed.
@warp-ds/react is available under the Apache-2.0 software license.