Skip to content

Commit 8ffcf12

Browse files
committed
docs: added further hints regarding scss errors
1 parent 80b3165 commit 8ffcf12

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@ DB UI Core provides robust HTML UI components, reusable visual styles, and power
3333
- [Getting started](docs/getStarted.adoc)
3434
- [GitHub - DB UI Core](https://github.com/db-ui/core/)
3535
- [Hosted version of DB UI Core living styleguide](https://db.de/db-ui)
36+
- [Migrating guide from version 1 of DB UI Core to version 2](docs/migrationGuide.adoc#user-content-db-ui-core-2-0-0-migration-guide)
3637

3738
## Core principals
3839

@@ -107,6 +108,25 @@ Please mind the [conventions for git commits](/docs/conventions.adoc#user-conten
107108
This is only the first version of our framework and we really want your feedback - either within the <a href="https://db.de/krnm74" target="_blank" rel="noopener noreferrer">DB UI Channel by Web Dev Community in Microsoft Teams (only available DB internally)</a>, or directly at [[email protected]](mailto:[email protected]). <!-- markdownlint-disable MD033 -->
108109
We're particularly keen to add as many examples to the behaviours as possible, to further clarify them.
109110

111+
## FAQ
112+
113+
### Our `scss` / `sass` build doesn't work any more after migrating from version 1 of DB UI Core.
114+
115+
In case that you're retrieving any errors like the following, please check for whether you've [provided the location of your `node_modules` folders path to your sass compiler](docs/migrationGuide.adoc#user-content-db-ui-core-2-0-0-migration-guide):
116+
117+
```
118+
./src/styles.scss - Error: Module build failed (from ./node_modules/mini-css-extract-plugin/dist/loader.js):
119+
ModuleBuildError: Module build failed (from ./node_modules/sass-loader/dist/cjs.js):
120+
SassError: Can't find stylesheet to import.
121+
122+
│ @use "@csstools/normalize.css/normalize.css";
123+
│ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
124+
125+
node_modules\@db-ui\core\sources\css\enterprise\db-ui-core.scss 7:1 @import
126+
node_modules\@db-ui\core\sources\css\enterprise\db-ui-core-include.scss 4:9 @import
127+
src\styles.scss 5:9 root stylesheet
128+
```
129+
110130
## Deutsche Bahn brand
111131

112132
As we'd like to perfectly support our users and customers on their digital journey, the usage of Deutsche Bahn brand and trademarks are bound to clear guidelines and restrictions even when being used with the code that we're providing with this product; Deutsche Bahn fully reserves all rights and ownership regarding the Deutsche Bahn brand, even though that we're providing the code of DB UI products free to use and release it under the Apache 2.0 license.

0 commit comments

Comments
 (0)