Skip to content

feat: add asobi init --template backend#35

Merged
Taure merged 1 commit into
mainfrom
feat/init-template-backend
Jul 12, 2026
Merged

feat: add asobi init --template backend#35
Taure merged 1 commit into
mainfrom
feat/init-template-backend

Conversation

@Taure

@Taure Taure commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Addresses PendragonNL's DX feedback: bare asobi init only drops a Lua stub, so a new user can't see what a whole backend looks like. Adds an opt-in template that scaffolds a complete, runnable backend.

Changes

  • asobi init --template backend fetches sdk_demo_backend by pinned tag (same mechanism as the engine demos) — docker-compose.yml, lua/config.lua, lua/match.lua, and the ASOBI_* env contract in one repo. Runs with docker compose up -d or asobi dev.
  • Engines()Names() so the "available templates" error lists all four (backend, defold, godot, unity).
  • Backend-specific init next-steps (docker compose up -d, README pointer).
  • Starter README (bare init) now documents asobi dev (local run), lua/config.lua (multiple modes), and --template backend. Test asserts all three.

Guardian constraints honoured

Bare init stays managed/Lua-first (front door); backend is opt-in behind --template (not --full). Fetch-by-tag, no compose/config embedded in the binary. Tier-1 only (compose + ASOBI_*), no sys.config in the tree — that's a docs deliverable.

Depends on

Pins sdk_demo_backend@v0.1.0. That tag is cut by widgrensit/sdk_demo_backend#3merge it first, then this.

Checks

gofmt clean, go vet clean, go build/go test ./... green. The network anti-drift E2E (ASOBI_TEMPLATE_E2E=1) will pass once v0.1.0 exists.

Scaffolds a complete runnable backend (fetches sdk_demo_backend by pinned
tag) - docker-compose.yml, the lua/config.lua mode manifest, and all
ASOBI_* env vars - alongside the existing engine templates. Bare `asobi
init` stays managed/Lua-first; the fuller backend is opt-in.

Also document `asobi dev`, config.lua (multiple modes), and the backend
template in the starter README.
@Taure
Taure merged commit 274f4ba into main Jul 12, 2026
1 check passed
@Taure
Taure deleted the feat/init-template-backend branch July 12, 2026 22:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant