README wording

README.md

@@ -1,10 +1,10 @@
 # infra
 
-Copier template for the root of a project: `docker-compose.yml` that includes every part, a `Makefile` that drives compose and delegates `fmt`, `check` and `build` to parts, `.env.example`, `.gitignore`, `CLAUDE.md` and pre-commit hooks.
+Copier template for the root of a project. With `layout: parts` it ships a `docker-compose.yml` that includes every part, a `Makefile` that drives compose and delegates `fmt`, `check` and `build` to parts, a `README.md` and an `.env.example` whose `COMPOSE_FILE` adds each part's `docker-compose.override.yml` and whose `COMPOSE_PROFILES` selects what runs on the machine. With `layout: single` a part template renders straight into the root and infra ships only `.gitignore`, `CLAUDE.md` and pre-commit hooks.
 
 A part is a directory with:
 
-- `docker-compose.yml` with root-relative paths, plus `docker-compose.local.yml` and `docker-compose.prod.yml` selected by `COMPOSE_ENV`
+- `docker-compose.yml` with root-relative paths and a profile per service, plus `docker-compose.override.yml.example` for what differs between machines
 - `Makefile` with `fmt`, `check` and `build` targets
 - `.env.example` appended to the root `.env` by `make env`
 - `CLAUDE.md` with the part's checking commands
@@ -12,6 +12,6 @@ A part is a directory with:
 Application services carry the `services` profile, databases and other infrastructure carry `external`.
 
 ```sh
-copier copy --trust -d 'parts=["backend","frontend"]' <this-repo> <dest>
+copier copy --trust -d layout=parts -d 'parts=["backend","frontend"]' <this-repo> <dest>
 copier update -a .copier/infra.yml
 ```

copier.yml

@@ -4,9 +4,28 @@ _answers_file: .copier/infra.yml
 _envops:
   keep_trailing_newline: true
 
+project_name:
+  type: str
+  help: Project name
+  default: Project
+
+project_description:
+  type: str
+  help: Short description
+  default: ""
+
+layout:
+  type: str
+  help: Where the code lives
+  choices:
+    Parts in their own directories: parts
+    A single part at the root: single
+  default: parts
+
 parts:
   type: str
   multiselect: true
+  when: "{{ layout == 'parts' }}"
   help: Parts that live in their own directory with a docker-compose.yml and a Makefile
   choices:
     backend: backend

template/.env.example

@@ -1 +0,0 @@
-COMPOSE_ENV=local

template/.gitignore

@@ -1,6 +0,0 @@
-.env
-.env.*
-!.env.example
-docker-compose.override.yml
-.DS_Store
-.idea

template/.gitignore.jinja

@@ -0,0 +1,16 @@
+.env
+.env.*
+!.env.example
+docker-compose.override.yml
+.DS_Store
+.idea
+{% if layout == 'single' %}.venv/
+__pycache__/
+*.pyc
+.ruff_cache/
+.pytest_cache/
+sessions/*.session*
+node_modules/
+.svelte-kit/
+/build/
+{% endif %}

template/.pre-commit-config.yaml.jinja

@@ -1,7 +1,17 @@
 repos:
   - repo: local
-    hooks:{% if not parts %} []{% endif %}
+    hooks:{% if layout == 'parts' and not parts %} []{% endif %}
-{% for part in parts %}      - id: {{ part }}-fmt
+{% if layout == 'single' %}      - id: fmt
+        name: fmt
+        entry: make fmt
+        language: system
+        pass_filenames: false
+      - id: check
+        name: check
+        entry: make check
+        language: system
+        pass_filenames: false
+{% endif %}{% for part in parts %}      - id: {{ part }}-fmt
         name: {{ part }} fmt
         entry: make -C {{ part }} fmt
         language: system
@@ -13,4 +23,4 @@ repos:
         language: system
         files: ^{{ part }}/
         pass_filenames: false
-{% endfor %}
+{% endfor %}

template/Makefile

@@ -1,28 +0,0 @@
-PARTS := $(patsubst %/Makefile,%,$(wildcard */Makefile))
-SERVICES := docker compose --profile services
-EXTERNAL := docker compose --profile external
-
-.PHONY: env external recreate rebuild restart logs down fmt check build
-
-env:
-	@test -f .env || cat .env.example $(addsuffix /.env.example,$(PARTS)) > .env
-
-external:
-	$(EXTERNAL) up -d
-
-recreate: external
-	$(SERVICES) up -d --force-recreate
-
-rebuild: build recreate
-
-restart:
-	$(SERVICES) restart
-
-logs:
-	$(SERVICES) logs -f --tail=100
-
-down:
-	$(EXTERNAL) --profile services down
-
-fmt check build:
-	@for part in $(PARTS); do $(MAKE) -C $$part $@ || exit 1; done

template/docker-compose.yml.jinja

@@ -1,7 +0,0 @@
-{% if parts %}include:
-{% for part in parts %}  - path:
-      - {{ part }}/docker-compose.yml
-      - {{ part }}/docker-compose.${COMPOSE_ENV:-local}.yml
-    project_directory: .
-{% endfor %}{% else %}services: {}
-{% endif %}

template/{% if layout == 'parts' %}.env.example{% endif %}.jinja

@@ -0,0 +1,3 @@
+{% if parts %}COMPOSE_FILE=docker-compose.yml{% for part in parts %}:{{ part }}/docker-compose.override.yml{% endfor %}
+COMPOSE_PROFILES={% if 'backend' in parts %}external,{% endif %}services
+{% endif %}

template/{% if layout == 'parts' %}Makefile{% endif %}

@@ -0,0 +1,25 @@
+PARTS := $(patsubst %/Makefile,%,$(wildcard */Makefile))
+
+.PHONY: env recreate rebuild restart logs down fmt check build
+
+env:
+	@test -f .env || awk 'FNR == 1 && NR > 1 { print "" } 1' .env.example $(addsuffix /.env.example,$(PARTS)) > .env
+	@for part in $(PARTS); do test -f $$part/docker-compose.override.yml || cp $$part/docker-compose.override.yml.example $$part/docker-compose.override.yml; done
+
+recreate:
+	docker compose up -d --force-recreate
+
+rebuild: build
+	docker compose up -d
+
+restart:
+	docker compose restart
+
+logs:
+	docker compose logs -f --tail=100
+
+down:
+	docker compose down
+
+fmt check build:
+	@for part in $(PARTS); do $(MAKE) -C $$part $@ || exit 1; done

template/{% if layout == 'parts' %}README.md{% endif %}.jinja

@@ -0,0 +1,14 @@
+# {{ project_name }}
+{% if project_description and project_description != project_name %}
+{{ project_description }}
+{% endif %}
+Runs in Docker, locally the same way as in production. Each part in `{{ parts | join('/`, `') }}/` brings its own `docker-compose.yml`, included from the root one. `COMPOSE_PROFILES` in `.env` selects the services that run on this machine. `docker-compose.override.yml` in each part holds what differs between machines: published ports and the aliases on the external `caddy` network.
+
+```sh
+make env
+make recreate
+```
+
+`make env` creates `.env` from the examples of every part and copies each `docker-compose.override.yml.example`. `make recreate` starts the selected profiles, `make rebuild` builds the images first, `make logs`, `make restart` and `make down` do what they say.
+
+`make fmt`, `make check` and `make build` run in every part. Part-specific targets live in the part's own Makefile: `make -C {{ parts[0] }} ...`.

template/{% if layout == 'parts' %}docker-compose.yml{% endif %}.jinja

@@ -0,0 +1,5 @@
+{% if parts %}include:
+{% for part in parts %}  - path: {{ part }}/docker-compose.yml
+    project_directory: .
+{% endfor %}{% else %}services: {}
+{% endif %}