kaisoellch / ix Goto Github PK

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

• 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.