Add example VS Code tasks and README

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-28 18:37:26 +02:00
co-authored by Claude Fable 5
parent 7ade98f8d0
commit b03bc2069f
2 changed files with 67 additions and 0 deletions
+32
View File
@@ -0,0 +1,32 @@
# love-tools
CI/CD templates for [LÖVE](https://love2d.org) (Love2D/Lua) game
projects, in the same spirit as [tic80-tools](../tic80-tools).
- `example-makefile.make` — project Makefile: local dev targets
(`build`, `love`, `web`, `export`, `watch`, `clean`) plus the
Woodpecker pipeline targets (`ci-version`, `ci-export`, `ci-upload`,
`ci-update`).
- `example-woodpecker.yaml` — Woodpecker pipeline: version → export
(`.love` package + love.js web build) → upload (scp to the droparea)
→ update (calls the teletypegames `/update` endpoint with
`platform=love`).
- `example-tasks.json` — VS Code `.vscode/tasks.json` with the common
dev tasks: **Run Löve** (`love .`, default build task,
`Cmd+Shift+B`), **Build & Run Löve**, **Build .love package** and
**Make build**.
## Usage in a game repo
1. Copy `example-makefile.make` to `Makefile` and set `PROJECT`
(the package is built as `dist/$(PROJECT).love`).
2. Copy `example-woodpecker.yaml` to `.woodpecker.yaml` and add the
`droparea_ssh_password` / `update_secret_key` secrets in Woodpecker.
3. Copy `example-tasks.json` to `.vscode/tasks.json`.
The pipeline uploads `$(PROJECT)-$(VERSION).love.zip`,
`$(PROJECT)-$(VERSION).html.zip` and the versioned `metadata.json` to
the droparea, then triggers `/update` twice: once with `platform=love`
(desktop package) and once with `platform=love-web` (web build).
Detailed documentation lives on the wiki: `/development/love`.