Grid puzzles that last 1–2 hours: a generic board/session framework (undo/redo, restart, moves, par + stars, solver hints, win/lose, juice) + six mechanics with generators and solvers + level packs (authored and generated along a difficulty curve, lazily) + star-gated world map, daily puzzle and saved progress. Requires core, progression, juice, procgen (auto-enabled). Example: games/examples/kit-puzzle ("Paper Grid": push, flow, match-3 packs + daily flow).
Setup
kits = ["puzzle"]
orientation = "portrait"local Puzzle = require("@kit/puzzle")
local packs = Puzzle.setup() -- loads data/packs/*.json, then core.save.load() (progress)
-- play scene script:
local level = Puzzle.packs.get("push"):level(3) -- or Puzzle.daily.level("flow", {...})
local s = Puzzle.session(level, { pack = level.pack, index = level.index })
local view = Puzzle.view.new(s, { origin = vec2(40, 300), cell = 96, gap = 6, skin = SKIN, palette = INKS })
local hud = Puzzle.ui.hud(s, { title = "Push 3", icons = ICONS, textColor = "#111111", onHint = function() view:hint() end, onBack = back })
s:on("won", function() Puzzle.record(s) after(0.9, function() Puzzle.ui.result(s, "win", { {"Map", back}, {"Next", nextLevel} }, { icons = ICONS }) end) end)
s:on("lost", function() Puzzle.ui.result(s, "lose", { {"Map", back}, {"Retry", function() s:restart() end} }) end)Keep Puzzle.setup() in a shared module (runs once). Scenes: menu (Puzzle.ui.packList), levels (Puzzle.ui.levelGrid), play.
Example game

Paper Grid
Push crates, link pipes, pop gems. A new flow puzzle every day.