Skip to content

UHF-11934 Theme builder for subtheme #328

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
khalima wants to merge 7 commits into from
Closed

UHF-11934 Theme builder for subtheme #328

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
5a27c9a
UHF-11934: Removed webpack related configurations and documentations.
khalima Jul 15, 2025
e14cb59
UHF-11934: Added theme builder configurations file.
khalima Jul 15, 2025
b70cb3d
UHF-11934: Removed postcss configurations.
khalima Jul 15, 2025
2741a6c
UHF-11934: Use correct path for breakpoint-sass.
khalima Jul 15, 2025
ab8bb03
UHF-11934: Updated the package.json to support @hdbt/theme-builder.
khalima Jul 15, 2025
83676ec
UHF-11934: Downgrade node version to 22, to support hds-core and hds-…
khalima Jul 15, 2025
9626fd0
UHF-11934: Updated packages.
khalima Jul 15, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions public/themes/custom/hdbt_subtheme/.eslintignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1 @@
node_modules/**/*
webpack.config.js
webpack.svgToSprite.js
2 changes: 1 addition & 1 deletion public/themes/custom/hdbt_subtheme/.nvmrc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1 @@
23
22
12 changes: 3 additions & 9 deletions public/themes/custom/hdbt_subtheme/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,7 @@

HDBT Subtheme is a so called "starterkit" which you can start using by enabling it in `/admin/appearance`.

HDBT Subtheme uses webpack module bundler to compile the JS and SCSS files. Also, the SVG icons are combined in to a
sprite.svg via webpack.
HDBT Subtheme uses HDBT theme builder to compile the JS and SCSS files. Also, the SVG icons are combined in to a sprite.svg via the theme builder.

As the HDBT Subtheme is only distributed via the [HELfi Platform](https://github.com/City-of-Helsinki/drupal-helfi-platform),
it doesn't have an upgrade path per se. In case there is a demand for upgrade-ability for existing projects then of
Expand Down Expand Up @@ -50,13 +49,8 @@ Explanations for commands.
Related files.
- `.nvmrc` : Defines the node version used to compile the theme.
- `package.json and package-lock.json` : Defines the node modules for compiling the theme.
- `postcss.config.js and postcss.plugins.js` : Configurations for the postcss-tool that is run when the theme is built.
You can read more about the tool here: https://postcss.org/
- `webpack.config.js` : Configuration file for the webpack-tool that is used to actually build the theme. Similar tool
to Gulp or Grunt. Usually if there is something wrong with the compiled theme files the culprit can be found here.
- `webpack.svgToSprite.js` : This file is used to create a sprite of all the icons used on the site. It gets all the
icons from the `./src`, compiles them into a sprite under `./dist/icons` and also creates a css-file where the icons are
referenced called `./dist/css/hdbt-icons.css`.
- `theme-builder/` : The theme builder tools.
- `theme-builder.mjs` : Configuration file for the theme builder tool that is used to build the theme.

Start SCSS/JS watcher by running

Expand Down
Loading