Scripts Directory

Non-Nx shell scripts and Docker helpers for the jdwlabs monorepo. These are not Nx projects and are excluded from Nx project detection via .nxignore.

Shell Scripts

All scripts are executable and accept arguments described in the usage comment at the top of each file.

Script	Purpose
build-image.sh	Build a jdwlabs/* image with the full OCI label set and hand off to docker buildx (caller passes --platform, --push/--load)
create-version.sh	Write a version.json file into an app's public/ dir after a semver release
format.sh	Run nx format:write across the workspace — called by the Nx format target in each app's project.json
prepare-config.sh	Swap config.json to its production values before a Docker image build
restore-config.sh	Restore config.json to its development defaults after a build
update-app.sh	Bump the appVersion in a Helm Chart.yaml to match the released semver tag
update-description.sh	Sync a DockerHub repo's Overview from that image's README.docker.md (needs DOCKERHUB_USERNAME/DOCKERHUB_PASSWORD)
update-version.sh	Update the version string in a build.gradle.kts (Spring Boot) to match the release tag

Docker

File	Purpose
docker/compose.yaml	Docker Compose config for the local development stack (databases, services)
docker/config.json	Docker-related configuration shared across services

Usage

# Start the local stack
docker compose -f scripts/docker/compose.yaml up -d

# Prepare an app config before building manually
bash scripts/prepare-config.sh apps/frontend/container/src/config.json

# Restore config after manual build
bash scripts/restore-config.sh apps/frontend/container/src/config.json

These scripts are typically invoked by Nx targets (via project.json command entries), not directly by developers.