Official website: https://tegel.scania.com/
Storybook: https://tds-storybook.tegel.scania.com/
The design system supports the design and development of digital solutions at Scania. The purpose is to secure a coherent, premium brand and user experience across all of Scania's digital touchpoints.
This package is currently in a beta stage. We are now working hard towards a 1.0 release, but if you want to try out the package today you can! It's available via NPM and can be installed using the installation guide below.
Read about how to get started on our website: https://tegel.scania.com/development/getting-started-development
The website also includes information on browser support.
We warmly welcome contributions from the community! Whether you're fixing bugs, adding new features, improving documentation, or just have questions, your help and questions are invaluable to us. Here's how you can get involved:
- Report Bugs or Request Features: Use the Issues page to report bugs or request new features.
- Submit Pull Requests: Feel free to submit PRs for bug fixes, feature implementations, or documentation updates. Please refer to our Contribution Guidelines for more details on submitting PRs.
- Code Conventions: Our code conventions are documented here. Please make sure your contributions adhere to these guidelines.
- Setting Up Development Environment: Follow the steps outlined above to set up your development environment. If you're contributing code, make sure to run tests and adhere to the coding standards mentioned.
- First-Time Contributors: If you're new to open source, have a look at the reported issues and see if there is something you can help out with. If you find something, assign your name to it and add a comment to keep everyone updated on its status.
- Questions or Discussions: Join our Teams channel for discussions, questions, or getting in touch with the team and community.
Your contributions, big or small, make a significant impact on the project. Thank you for your support!
The code conventions used in (and enforced by) Tegel is documented here.
- Make sure you are using the required node.js version specified in
tegel/package.json
(node 20 at the time of writing). - Make sure you have Docker installed. It is needed for running unit tests.
- Run
npm install
in the root directory. - Run
npm install
in thepackages/core
directory. - Development version of Storybook with additional plugins and beta components can be activated by setting the environment variable
STORYBOOK_ENV
todev
in the same terminal where you run rest of the commands.
export STORYBOOK_ENV=dev
- Make sure you are in the root directory, and start the dev server with
npm run start
.
- Alternatively navigate to
packages/core
and start the dev server withnpm run storybook
Get in touch with the team and the community:
All CSS, HTML and JS code are available under the MIT license. The Scania brand identity, logos and photographs found in this repository are copyrighted Scania CV AB and are not available on an open source basis or to be used as examples or in any other way, if not specifically ordered by Scania CV AB.