21 lines
1.4 KiB
Markdown
21 lines
1.4 KiB
Markdown
# newproject
|
|
|
|
Composes a project from the templates in this organization: `infra` at the root, then `backend-python`, `frontend-svelte` and `caddy` on top, each with its own answers file in `.copier/`.
|
|
|
|
```sh
|
|
source ~/projects/templates/newproject/shell.sh
|
|
newproject ~/projects/my-thing
|
|
updateproject # every part
|
|
updateproject backend # one part
|
|
```
|
|
|
|
`newproject` asks for the parts, the backend language, the frontend framework and how the frontend is served, then hands over to each template's own questions. Every prompt has a flag for non-interactive use:
|
|
|
|
```sh
|
|
newproject ~/projects/my-thing --parts backend,frontend,caddy --backend python --frontend svelte --serve bun --defaults
|
|
```
|
|
|
|
One part alone is rendered at the root of the project; two parts live in `backend/` and `frontend/`. After rendering, `make env` creates `.env` and every `docker-compose.override.yml` from their examples. `updateproject` needs a clean working tree and commits each part's update separately, so the next part starts from a clean tree again; conflicts stay in those commits for you to resolve. Templates are cloned from `https://git.kotikot.com/templates` unless `TEMPLATES_DIR` points at a directory with local checkouts; `TEMPLATES_REF=HEAD` renders their working trees instead of the latest tag.
|
|
|
|
Requires `uv`; `bun`, `docker` and `pre-commit` are used by the generated projects.
|