Makefile Debugging, Parallelism & CI

make --trace test

# Show when each target is considered and updated.

make --debug=a

# Print broad internal diagnostics.

$(info OBJ=$(OBJ))

# Emit a variable during parsing.

$(info CFLAGS origin=$(origin CFLAGS) flavor=$(flavor CFLAGS) value=$(value CFLAGS))

# See where a value came from and how it expands.

make -rR --warn-undefined-variables

# Eliminate implicit rule noise.

subdirs:
  $(MAKE) -C api
  $(MAKE) -C web

# Propagate parallelism automatically using `$(MAKE)`.

make -j8 --output-sync=target

# Keep log lines grouped by target when running with jobs.

.PHONY: ci
ci: lint test build

# Create a single target for consistent pipeline execution.

-include .env.mk

# Load machine-specific settings without hardcoding them in shared files.

.PHONY: deps
deps:
  npm ci

# Use lockfile-based install inside a phony or stamp target.

SHELL := /usr/bin/env bash
.SHELLFLAGS := -eu -o pipefail -c

# Use bash with strict flags for recipes.

.ONESHELL:
release:
  set -euo pipefail
  pnpm build
  aws s3 sync dist/ s3://my-bucket

# Fail fast in multi-line recipes.

ifndef VERSION
$(error VERSION is required. Usage: make release VERSION=1.2.3)
endif

# Abort early when a required variable is missing.