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.

Quickstart - Documentation - Community

Installation

You can find a getting started guide here

Development

Installation

yarn install

Build

yarn build || yarn build --filter=<workspace-name>

Development

yarn start || yarn start --filter=<workspace-name>

Execute unit tests

yarn test

Visual regression testing

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 🎉

Documentation

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

Release

yarn release

Project structure

Package core

Contains all styles and the webcomponents.

published as @siemens/ix

Package react

Contains the wrapper components for react.

published as @siemens/ix-react

Package angular

Contains the wrapper components for angular.

published as @siemens/ix-angular

Package html-test-app, react-test-app and angular-test-app

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

Package documentation

Contains the documentation.

Package aggrid

Contains the brand and classic theme for the aggrid library

published as @siemens/ix-aggrid

Git hooks via husky

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

🤝 Contributing

Contributions, issues and feature requests are welcome!

👨‍💻 Maintainers

• Daniel Leroux daniel.leroux@siemens.com
• Lukas Maurer lukas.maurer@siemens.com
• Carlos Leandro Cruz Ferrer carlos.cruz_ferrer@siemens.com
• Gonçalo Ferreira goncalo.alves-ferreira@siemens.com

📝 License

Copyright © 2022 Siemens AG.

This project is MIT licensed.