dweller.json manifest

dweller.json lives in your project root. dweller init writes it; dweller push reads it. Commit it so you, your teammates and your AI agent can repeat releases exactly.

{
  "game": "starfall",
  "title": "Starfall",
  "tagline": "Catch falling stars before the night runs out.",
  "description_file": "STORE.md",
  "tags": ["arcade", "cozy", "pixel art"],
  "engine": "Godot 4.7",
  "ai_tools": ["Claude Code"],
  "builds": [
    { "platform": "windows", "path": "build/windows", "exec": "Starfall.exe" },
    { "platform": "macos",   "path": "build/macos/Starfall.app", "arch": "universal" },
    { "platform": "linux",   "path": "build/linux", "exec": "Starfall.x86_64" },
    { "platform": "web",     "path": "build/web" },
    { "platform": "android", "path": "build/Starfall.apk" }
  ]
}

Field	Meaning
`game`	The game's URL name on Dweller (`https://dweller.games/games/<game>`). Required for `push`.
`title`, `tagline`, `tags`, `engine`, `ai_tools`	Used when `dweller init` or `dweller push` creates the game, and by `dweller update --from-manifest`.
`description_file`	Markdown file used for the store description.
`builds[].platform`	`windows`, `macos`, `linux`, `web`, `android` or `gba`.
`builds[].path`	A file (zip, exe, apk, gba, AppImage) or a folder. Folders are zipped on upload. A `.app` folder is zipped with the bundle at the top level.
`builds[].arch`	`x64` (default for desktop), `arm64`, `universal` or `any`.
`builds[].exec`	Program to run after unpacking, relative to the build root. Optional: Dweller detects it when there's only one candidate.

View as Markdown (handy for feeding to an AI)