README wording

README.md

@@ -1,8 +1,8 @@
 # frontend-svelte
 
-Copier template for a `frontend/` part: SvelteKit on Bun with Tailwind v4, ultracite (biome) and optional shadcn-svelte, served by a Bun server with SSR, as a static SPA behind `serve.ts`, or as a static SPA that the backend api serves from `frontend/build`.
+Copier template for a SvelteKit frontend, either as a `frontend/` part next to other parts or alone at the root of the project (`layout`): SvelteKit on Bun with Tailwind v4, ultracite (biome) and optional shadcn-svelte, served by a Bun server with SSR, as a static SPA behind `serve.ts`, or as a static SPA that the backend api serves from `frontend/build`.
 
-Ships `frontend/docker-compose.yml` with root-relative paths, `docker-compose.local.yml` (published ports) and `docker-compose.prod.yml` (the `caddy` network), a `Makefile` with `fmt`, `check`, `build` and `dev`, `.env.example`, `CLAUDE.md`, `.claude/rules` for Svelte and ultracite, the Svelte MCP server and `.impeccable/` scaffolding. Meant to be applied on top of the `infra` template.
+Ships `frontend/docker-compose.yml` with root-relative paths and profiles per service, `docker-compose.override.yml.example` (the `caddy` network aliases, copied by `make env`), a `Makefile` with `fmt`, `check`, `build` and `dev`, `.env.example`, `CLAUDE.md`, `.claude/rules` for Svelte and ultracite, the Svelte MCP server and `.impeccable/` scaffolding. Applied on top of the `infra` template, `layout: parts` or `layout: single` respectively.
 
 ```sh
 copier copy --trust -d project_name="My Thing" -d serve=bun <this-repo> <dest>

copier.yml

@@ -13,6 +13,14 @@ project_slug:
   help: Package name, snake_case
   default: "{{ project_name | lower | replace(' ', '_') | replace('-', '_') | replace('.', '_') }}"
 
+layout:
+  type: str
+  help: Where the frontend lives
+  choices:
+    In frontend/ next to other parts: part
+    At the root of the project: root
+  default: part
+
 serve:
   type: str
   help: How the frontend is served
@@ -44,5 +52,15 @@ frontend_adapter:
   when: false
   default: "{{ 'bun' if serve == 'bun' else 'static' }}"
 
+part_dir:
+  type: str
+  when: false
+  default: "{{ 'frontend' if layout == 'part' else '.' }}"
+
+prefix:
+  type: str
+  when: false
+  default: "{{ 'frontend/' if layout == 'part' else '' }}"
+
 _tasks:
-  - "{% if _copier_operation == 'copy' and install_deps %}sh -c 'cd frontend && bun install'{% else %}true{% endif %}"
+  - "{% if _copier_operation == 'copy' and install_deps %}sh -c 'cd {{ part_dir }} && bun install'{% else %}true{% endif %}"

template/.claude/settings.json.jinja

@@ -4,7 +4,7 @@
       {
         "hooks": [
           {
-            "command": "cd frontend && bun run fix --skip=correctness/noUnusedImports",
+            "command": "{% if layout == 'part' %}cd frontend && {% endif %}bun run fix --skip=correctness/noUnusedImports",
             "type": "command"
           }
         ],

template/frontend/.env.example

@@ -1 +0,0 @@
-PUBLIC_API_BASE_URL=/api

template/frontend/Makefile.jinja

@@ -1,17 +0,0 @@
-COMPOSE := docker compose --project-directory ..
-
-.PHONY: fmt check build dev
-
-fmt:
-	bun run fix
-
-check:
-	bun run check
-	bun run lint
-
-build:
-{% if serve == 'api' %}	$(COMPOSE) run --rm frontend-dev sh -c "bun install && bun run build"
-{% else %}	$(COMPOSE) build frontend
-{% endif %}
-dev:
-	bun run dev

template/frontend/docker-compose.local.yml.jinja

@@ -1,8 +0,0 @@
-services:
-{% if serve != 'api' %}  frontend:
-    ports:
-      - "127.0.0.1:3000:3000"
-
-{% endif %}  frontend-dev:
-    ports:
-      - "127.0.0.1:3000:3000"

template/{{ part_dir }}/.env.example.jinja

@@ -0,0 +1,4 @@
+{% if layout == 'root' %}COMPOSE_PROFILES=services
+
+{% endif %}PUBLIC_API_BASE_URL=/api
+ALLOWED_HOSTS=

template/{{ part_dir }}/Makefile.jinja

@@ -0,0 +1,37 @@
+COMPOSE := docker compose{% if layout == 'part' %} --project-directory ..{% endif %}
+
+.PHONY: {% if layout == 'root' %}env recreate rebuild restart logs down {% endif %}fmt check build dev
+
+fmt:
+	bun run fix
+
+check:
+	bun run check
+	bun run lint
+
+build:
+{% if serve == 'api' %}	$(COMPOSE) run --rm frontend-dev sh -c "bun install && bun run build"
+{% else %}	$(COMPOSE) build frontend
+{% endif %}
+dev:
+	bun run dev
+{% if layout == 'root' %}
+env:
+	@test -f .env || cp .env.example .env
+	@test -f docker-compose.override.yml || cp docker-compose.override.yml.example docker-compose.override.yml
+
+recreate:
+	$(COMPOSE) up -d --force-recreate
+
+rebuild: build
+	$(COMPOSE) up -d
+
+restart:
+	$(COMPOSE) restart
+
+logs:
+	$(COMPOSE) logs -f --tail=100
+
+down:
+	$(COMPOSE) down
+{% endif %}

template/{{ part_dir }}/docker-compose.override.yml.example.jinja

@@ -1,8 +1,15 @@
 {%- set dash = project_slug | replace('_', '-') -%}
-{% if serve != 'api' -%}
 services:
-  frontend:
+{% if serve != 'api' %}  frontend:
     networks:
+      default: {}
+      caddy:
+        aliases:
+          - {{ dash }}-frontend
+
+{% endif %}  frontend-dev:
+    networks:
+      default: {}
       caddy:
         aliases:
           - {{ dash }}-frontend
@@ -10,6 +17,3 @@ services:
 networks:
   caddy:
     external: true
-{%- else -%}
-services: {}
-{%- endif %}

template/{{ part_dir }}/docker-compose.yml.jinja

@@ -1,15 +1,15 @@
 services:
 {% if serve != 'api' %}  frontend:
-    build: frontend
+    build: {{ part_dir }}
     image: {{ project_slug }}/frontend
     profiles: [frontend, services]
     restart: unless-stopped
     env_file:
       - path: .env
         required: false
-      - path: frontend/.env
+{% if layout == 'part' %}      - path: frontend/.env
         required: false
-    command: {% if serve == 'bun' %}[build/index.js]{% else %}[run, serve.ts]{% endif %}
+{% endif %}    command: {% if serve == 'bun' %}[build/index.js]{% else %}[run, serve.ts]{% endif %}
 
 {% endif %}  frontend-dev:
     image: oven/bun:alpine
@@ -19,12 +19,12 @@ services:
     env_file:
       - path: .env
         required: false
-      - path: frontend/.env
+{% if layout == 'part' %}      - path: frontend/.env
         required: false
-    environment:
+{% endif %}    environment:
       API_PROXY_TARGET: http://api:8080
     volumes:
-      - ./frontend:/app
+      - {{ './frontend' if layout == 'part' else '.' }}:/app
       - frontend_node_modules:/app/node_modules
       - frontend_svelte_kit:/app/.svelte-kit
     command: [sh, -c, "bun install && bun run dev --host 0.0.0.0 --port 3000"]

template/{{ part_dir }}/vite.config.ts

@@ -2,9 +2,14 @@ import { sveltekit } from "@sveltejs/kit/vite";
 import tailwindcss from "@tailwindcss/vite";
 import { defineConfig } from "vite";
 
+const allowedHosts = process.env.ALLOWED_HOSTS
+  ? process.env.ALLOWED_HOSTS.split(",")
+  : undefined;
+
 export default defineConfig({
   plugins: [tailwindcss(), sveltekit()],
   server: {
+    allowedHosts,
     proxy: {
       "/api": {
         changeOrigin: true,

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

@@ -0,0 +1,12 @@
+# {{ project_name }}
+
+Runs in Docker, locally the same way as in production. `COMPOSE_PROFILES` in `.env` selects the services that run on this machine. `docker-compose.override.yml` holds what differs between machines: published ports and the aliases on the external `caddy` network.
+
+```sh
+make env
+make recreate
+```
+
+`make env` creates `.env` and `docker-compose.override.yml` from their examples. `make recreate` starts the selected profiles, `make rebuild` builds the image first, `make logs`, `make restart` and `make down` do what they say.
+
+`make dev` runs the Vite dev server on the host, `make fmt` formats, `make check` runs svelte-check and the linter.