Siemens Industrial Experience (iX) monorepo
iX is an open-source design system for designers and developers, to consistently create the perfect digital experience for industrial software products.
You can find a getting started guide here
yarn install
yarn build || yarn build --filter=<workspace-name>
yarn start || yarn start --filter=<workspace-name>
yarn test
Docker cli must be installed on your system
If you execute the visual-regression tests, please be sure to execute the build step before.
- Build the library
yarn build
- Start playwright docker container. (Currently v1.30.0-focal but can be a newer version)
docker run -p 8080:8080 -v $(pwd):/work/ -w /work -it mcr.microsoft.com/playwright:v1.30.0-focal /bin/bash
-
Start the test suite
- All tests run
yarn visual-regression-ci
- Workspace run
yarn workspace @siemens/ix test:e2e
- All tests run
-
Check the results in
packages/<workspace>/playwright-report/index.html
-
Adapt and update snapshots with
yarn workspace @siemens/ix test:e2e <test name> -u
-
Check the git diff and commit changes ๐
To see all image references it is necessary to create a personal access token (https://www.figma.com/developers/api#access-tokens).
Store the token as environment variable "FIGMA_API_TOKEN" or in the .env file inside root.
Serve documentation locally
yarn start --filter=documentation
yarn release
Contains all styles and the webcomponents.
published as @siemens/ix
Contains the wrapper components for react.
published as @siemens/ix-react
Contains the wrapper components for angular.
published as @siemens/ix-angular
These packages contain playground applications to explore and test the respective ix
components.
The preview source code for the documentation is also located inside the x-test-app
's. (src/preview-examples
)
These preview-examples will be translated to markdown files and get copied into ./packages/documentation/docs/auto-generated/previews
.
Not published
Contains the documentation.
Contains the brand and classic theme for the aggrid library
published as @siemens/ix-aggrid
Our pipeline lints each commit pushed to remote. To verify that you don't need to rebase existing commits please install our git hooks.
# Activate hooks
npx husky install
# or
yarn husky install
Contributions, issues and feature requests are welcome!
- Daniel Leroux [email protected]
- Lukas Maurer [email protected]
Copyright ยฉ 2022 Siemens AG.
This project is MIT licensed.