Donn

Docker image which compiles CSS (from SASS) and JS files.

Docker Hub has variants for Node 16 and 18 (arm64 and amd64).

Requirements

• You mount your local path (e.g. Drupal theme) to /data in the container.
• Your local path has folder src/scss which contains SASS files.
• Your local path has folder src/js which contains JavaScript files.

Tools

• Gulp 4 (https://www.npmjs.com/package/gulp) - Frozen in time as there is no certainty for v5.
• Webpack [TODO]

Using image in your project

Examples on Drupal project:

docker run -it --rm -v $(pwd)/path/to/theme:/data druidfi/donn:node-18 gulp production

docker run -it --rm -v $(pwd)/path/to/theme:/data druidfi/donn:node-18 gulp development

docker run -it --rm -v $(pwd)/path/to/theme:/data druidfi/donn:node-18 gulp watch

Using it in druidfi/tools

You can add these to e.g. tools/make/project/theme.mk and have NODE_VERSION=18 in your .env file:

THEME_PATH := $(shell pwd)/$(WEBROOT)/themes/custom/druid_theme

PHONY += drupal-build-theme
drupal-build-theme:
	$(call step,Build theme with Gulp...\n)
	@docker run -it --rm -v $(THEME_PATH):/data druidfi/donn:node-$(NODE_VERSION) gulp production

PHONY += drupal-watch-theme
drupal-watch-theme:
	$(call step,Watch theme with Gulp...\n)
	@docker run -it --rm -v $(THEME_PATH):/data druidfi/donn:node-$(NODE_VERSION) gulp watch

Environment variables

Environment variables (and their default values) which can be used to change configuration:

• BROWSERSLIST="last 2 version, not dead"
• DIST_FOLDER=dist
• SRC_FOLDER=src

Build images

Locally with M1:

docker buildx bake -f docker-bake.hcl --pull --progress plain --no-cache --load --set "*.platform=linux/arm64"

Build and push images to Docker Hub:

docker buildx bake -f docker-bake.hcl --pull --no-cache --push

Where the name "Donn" comes from?

In Irish mythology, Donn ("the dark one", from Proto-Celtic: *Dhuosnos) is an ancestor of the Gaels and is believed to have been a god of the dead. Donn is said to dwell in Tech Duinn (the "house of Donn" or "house of the dark one"), where the souls of the dead gather.