john/McRogueFace
1
0
Fork 0
Code Issues 32 Pull requests Projects Releases Wiki Activity

[7DRL Prep] itch.io deployment pipeline #250

New issue
Closed
opened 2026-02-09 02:44:53 +00:00 by john · 3 comments
john commented 2026-02-09 02:44:53 +00:00
Owner
Copy link

Goal

Create packaging and deployment pipeline for itch.io WebAssembly games.

Current State

  • make wasm produces working artifacts (~16 MB: .html, .js, .wasm, .data)
  • tools/package.sh handles Linux/Windows only - no WASM
  • No itch.io config, butler setup, or deployment scripts
  • Build artifacts are current (Feb 7)

What's Needed

  1. tools/package-wasm.sh - Package WASM artifacts for itch.io upload
  2. Makefile targets: package-wasm, package-playground
  3. Rename/wrap mcrogueface.html as index.html for itch.io
  4. Test upload and verify loading in itch.io iframe
  5. Optional: butler CLI automation for push-to-deploy

itch.io Constraints

  • Upload as ZIP, mark as HTML5
  • <1,000 files, <500 MB total, <200 MB per file
  • Entry point must be index.html
  • itch.io serves .wasm with correct MIME type and applies gzip

Depends On

  • #246 (mobile fullscreen) for good mobile experience
  • #247 (SDL audio) for sound
  • #248 (COS remaster) for the game content to deploy

Detailed Report

.claude/reports/itchio_deployment.md

## Goal Create packaging and deployment pipeline for itch.io WebAssembly games. ## Current State - `make wasm` produces working artifacts (~16 MB: .html, .js, .wasm, .data) - `tools/package.sh` handles Linux/Windows only - no WASM - No itch.io config, butler setup, or deployment scripts - Build artifacts are current (Feb 7) ## What's Needed 1. `tools/package-wasm.sh` - Package WASM artifacts for itch.io upload 2. Makefile targets: `package-wasm`, `package-playground` 3. Rename/wrap `mcrogueface.html` as `index.html` for itch.io 4. Test upload and verify loading in itch.io iframe 5. Optional: butler CLI automation for push-to-deploy ## itch.io Constraints - Upload as ZIP, mark as HTML5 - <1,000 files, <500 MB total, <200 MB per file - Entry point must be `index.html` - itch.io serves .wasm with correct MIME type and applies gzip ## Depends On - #246 (mobile fullscreen) for good mobile experience - #247 (SDL audio) for sound - #248 (COS remaster) for the game content to deploy ## Detailed Report `.claude/reports/itchio_deployment.md`
john commented 2026-02-09 02:45:36 +00:00
Author
Owner
Copy link

Intended labels (apply manually due to MCP label bug): priority:tier1-active, Minor Feature

Dependencies set: blocked by #246 and #247

**Intended labels** (apply manually due to MCP label bug): `priority:tier1-active`, `Minor Feature` Dependencies set: blocked by #246 and #247
john commented 2026-02-10 02:07:24 +00:00
Author
Owner
Copy link

itch.io deployment is working as of the wasm-game build target (726a9cf). The canvas-only shell deploys and runs correctly on itch.io.

Audio (#247) closed via 0969f7c. Mobile (#246) is sufficient via 726a9cf.

Remaining: formalize packaging script and butler automation, but manual upload works now. Not blocking.

itch.io deployment is working as of the `wasm-game` build target (726a9cf). The canvas-only shell deploys and runs correctly on itch.io. Audio (#247) closed via 0969f7c. Mobile (#246) is sufficient via 726a9cf. Remaining: formalize packaging script and butler automation, but manual upload works now. Not blocking.
john commented 2026-02-15 00:31:00 +00:00
Author
Owner
Copy link

Closing -- make wasm-game produces deployable artifacts and the pipeline to itch.io works. Formal butler automation and package-wasm Makefile targets would be nice but aren't needed when the manual upload process is straightforward. Can revisit if deployment becomes frequent enough to justify automation.

Closing -- `make wasm-game` produces deployable artifacts and the pipeline to itch.io works. Formal butler automation and `package-wasm` Makefile targets would be nice but aren't needed when the manual upload process is straightforward. Can revisit if deployment becomes frequent enough to justify automation.
john closed this issue 2026-02-15 00:31:08 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
threedee
emscripten-mcrogueface
rogueliketutorial25
alpha_presentable
alpha_streamline_2
alpha_streamline_1
interpreter_mode
grid_entity_integration
reprs_and_member_names
break_up_ui_h
standardize_font_handling
standardize_vector_handling
standardize_color_handling
standardize_texture_handling
raii_pyobjects
rebase-for-7DRL_Feb-2024
engjam_uicollection
engjam_ui_overhaul
0.2.3-prerelease-7drl2026-emscripten
Labels
Clear labels   
Alpha Release Requirement

This issue is a blocker to 0.1 Alpha release of McRogueFace.

  
Bugfix

   
Demo Target

Functionality to demonstrate; Depends on new features, but this issue isn't for writing them.

  
Documentation

   
Major Feature

Significant time and effort required.

  
Minor Feature

Some effort required to create or overhaul functionality.

  
priority:tier1-active

Current development focus - critical path to v1.0

  
priority:tier2-foundation

Important foundation work - not blocking v1.0

  
priority:tier3-future

Future features - deferred until after v1.0

  
priority:tier4-deferred

   
Refactoring & Cleanup

no new functionality, just improving the codebase.

  
system:animation

Animation and property interpolation

  
system:documentation

Documentation infrastructure

  
system:grid

Grid system and spatial containers

  
system:input

Input handling and events

  
system:performance

Performance optimization and profiling

  
system:procgen

Procedural Generation (Noise, BSP, Heightmap)

  
system:python-binding

Python/C++ binding layer

  
system:rendering

Rendering pipeline and visuals

  
system:ui-hierarchy

UI component hierarchy and composition

  
Tiny Feature

quick and easy - a few lines or with little interconnection around the codebase

  
workflow:blocked

Blocked by other work - waiting on dependencies

  
workflow:needs-benchmark

Needs performance testing and benchmarks

  
workflow:needs-documentation

Needs documentation before or after implementation

No labels
Alpha Release Requirement
Bugfix
Demo Target
Documentation
Major Feature
Minor Feature
priority:tier1-active
priority:tier2-foundation
priority:tier3-future
priority:tier4-deferred
Refactoring & Cleanup
system:animation
system:documentation
system:grid
system:input
system:performance
system:procgen
system:python-binding
system:rendering
system:ui-hierarchy
Tiny Feature
workflow:blocked
workflow:needs-benchmark
workflow:needs-documentation
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Depends on
#246 [7DRL Prep] WASM fullscreen on mobile devices
john/McRogueFace
#247 [7DRL Prep] SDL audio working in browser (WASM)
john/McRogueFace
Reference
john/McRogueFace#250
No description provided.