Skip to content

[codex] Rebaseline Electrobun docs after WGPU release #168

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
devallibus merged 1 commit into from
Mar 6, 2026
Merged

[codex] Rebaseline Electrobun docs after WGPU release #168

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
- Runtime provider contracts in `webtau/provider`: `CoreProvider`, `WindowAdapter`, `EventAdapter`, `FsAdapter`, `DialogAdapter`.
- Provider registry APIs in `webtau/core`: `registerProvider`, `getProvider`, `resetProvider` with lazy Tauri auto-registration.
- Adapter override hooks in `webtau/window`, `webtau/event`, `webtau/fs`, and `webtau/dialog`.
- Experimental Electrobun runtime as an opt-in trial path (install with `webtau@alpha`; not the default scaffold target). See `examples/electrobun-counter` and [active milestones](https://github.com/devallibus/gametau/milestones).
- Initial Electrobun runtime spike as an opt-in alpha path (via `webtau@alpha` at the time, and not yet a scaffold target). That baseline was later expanded by the `v0.7.0` milestone into explicit shell scaffolding, runtime auto-detection, and GPUWindow smoke coverage.

### Changed
- `create-gametau` base scaffold now wires `bootstrapTauri()` in desktop mode and ships task lifecycle seams in `src/services/backend.ts`.
Expand Down
12 changes: 7 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ Your frontend calls `invoke("command_name")` everywhere. At runtime:

- **Inside Tauri** → routes through Tauri IPC at native speed
- **In a browser** → calls the WASM export directly
- **With a registered runtime provider** → routes through the provider (for experimental runtimes)
- **With a registered runtime provider** → routes through the provider (for provider-backed runtimes such as Electrobun)

The switch is automatic. Zero `if` statements in your game code.

Expand Down Expand Up @@ -459,7 +459,7 @@ Expands to:
| `createTauriCoreProvider()` | `CoreProvider` wrapper around `@tauri-apps/api/core` |
| `createTauriEventAdapter()` | `EventAdapter` wrapper around `@tauri-apps/api/event` |

**`webtau/adapters/electrobun`** — Electrobun desktop bootstrap helpers (experimental).
**`webtau/adapters/electrobun`** — Electrobun desktop bootstrap helpers for explicit BrowserWindow and GPUWindow shell paths.

| API | Purpose |
|---|---|
Expand Down Expand Up @@ -676,7 +676,7 @@ Expected sizes:
| Desktop (Tauri) | Stable |
| Desktop (Electrobun) | Supported via explicit shell selection |

Update: Electrobun now ships with scaffold/runtime auto-detection for `window.__ELECTROBUN__`, an explicit `create-gametau --desktop-shell electrobun` path, and BrowserWindow/GPUWindow counter build lanes. The remaining work is around embedded `<electrobun-wgpu>` showcases, broader GPUWindow renderer abstractions, and release-gate hardening.
As of March 6, 2026, `gametau` ships scaffold/runtime auto-detection for `window.__ELECTROBUN__`, an explicit `create-gametau --desktop-shell electrobun` path, and BrowserWindow/GPUWindow example lanes. The remaining Electrobun work is now follow-through inside `gametau`: embedded `<electrobun-wgpu>` showcases, broader GPUWindow renderer abstractions, and release-gate hardening.

### Electrobun support

Expand All @@ -695,18 +695,20 @@ Electrobun is available as an alternative desktop shell. The current supported s
- Multi-platform CI dogfood workflow (Ubuntu, macOS, Windows)
- Public exports from `webtau/adapters/electrobun`

**What's not yet done:**
**Remaining follow-up work:**
- BrowserWindow + embedded `<electrobun-wgpu>` showcase
- Broader GPUWindow example coverage and renderer abstractions beyond the counter proof lane
- Release-gate promotion and packaging hardening beyond smoke coverage

Earlier upstream-blocked issues [#98](https://github.com/devallibus/gametau/issues/98), [#100](https://github.com/devallibus/gametau/issues/100), [#104](https://github.com/devallibus/gametau/issues/104), and [#106](https://github.com/devallibus/gametau/issues/106) now describe historical baseline work. Remaining milestone tracking is centered on [#159](https://github.com/devallibus/gametau/issues/159) and [#162](https://github.com/devallibus/gametau/issues/162).

See [ELECTROBUN-SHOWCASE.md](./ELECTROBUN-SHOWCASE.md) for the integration walkthrough and [`RUNTIME-PORTABILITY-READINESS.md`](./RUNTIME-PORTABILITY-READINESS.md) for the full capability matrix and known gaps.

---

## Roadmap

**Electrobun (shipped → next steps):**
**Electrobun (shipped → release follow-up):**
- ✅ Full adapter surface: window, event, filesystem, dialog
- ✅ `bootstrapElectrobun()` and provider registry pattern
- ✅ Auto-detect Electrobun runtime in templates and browser entrypoints
Expand Down