This repository keeps indexes of the components, themes and guidelines in NL Design System. As these might be available in the community, in NL Design System or elsewhere it is useful to have one overview of what's available and use it to generate the documentation website or stories.
We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. Read our Code of Conduct if you haven't already.
This project is free and open-source software licensed under the European Union Public License (EUPL) v1.2. Documentation is licensed as Creative Commons Zero 1.0 Universal (CC0-1.0)
For information about proprietary assets in this repository, please carefully read the NOTICE file.
The pnpm run build script requires a GH_ISSUES_TOKEN enviroment variable. To run it locally take the following steps:
- Create a
.envfile - Create a Personal access token in GitHub
- Go to GitHub
settings->Developer Settings->Personal access tokens->Fine-grained tokens - Generate new token with
- Token name:
Local GH_ISSUES_TOKEN - expiration: choose end date of your contract
- Resource owner:
NL Design System - Repository access:
Only select repositoriesand selectnl-design-system/backlog - Repository permissions:
Issues: Read-only - Organisation permissions:
Projects: Read-only - Copy token
- Token name:
- In the
.envfile addexport GITHUB_ISSUES_TOKEN="<paste your token>"
Note: This is an access token! It should only be saved locally and never be committed to GitHub or shared with anyone else.
Now you can run source .env; pnpm run build locally.
The @nl-design-system/component-progress package needs to be updated everytime a release is made, regardless of changes in the repository. This is because it calls GitHub API's for generating JSON files based on GitHub projectboards.
To make this happen we use --force-publish=@nl-design-system/component-progress in de release script.