docs: comprehensive UI porting guide for archipelagos skill #19

Closed

mik-tf wants to merge 1 commit from development_archipelago_porting_guide into development

mik-tf commented

2026-02-18 02:54:54 +00:00

Owner

Summary

Expand the "Porting an Existing UI" section in the archipelagos skill from a brief 30-line checklist into a comprehensive step-by-step guide (~400 lines)
Update the Dioxus skill to reference the archipelagos skill for island work, clarifying that islands don't use Router or Server Functions

What's covered in the new porting guide

Two porting modes: SDK (hero_osis) vs HTTP (external REST API)
View enum with FromStr trait: Complete pattern with parameterized views
Dual-target service layer: gloo-net for WASM + native stubs for cargo check
Tera-to-RSX conversion table: 15+ template patterns mapped to RSX equivalents
JavaScript interop: js_sys::eval patterns for clipboard, audio, syntax highlighting
Island entry point: Signal-based navigation (not Dioxus Router)
Standalone lib.rs boilerplate: cfg-gated web component registration
CI/Clippy gotchas: 6 hard-won lessons from real CI failures
Complete porting checklist: 13-point verification list

Context

Based on lessons learned porting hero_books (Tera templates on port 8883) to a native Dioxus island in hero_archipelagos (PR lhumina_code/hero_archipelagos#14).

Test plan

Documentation-only changes, no runtime code
Verify skill renders correctly in Forgejo markdown preview

🤖 Generated with Claude Code

## Summary - Expand the "Porting an Existing UI" section in the archipelagos skill from a brief 30-line checklist into a comprehensive step-by-step guide (~400 lines) - Update the Dioxus skill to reference the archipelagos skill for island work, clarifying that islands don't use Router or Server Functions ## What's covered in the new porting guide - **Two porting modes**: SDK (hero_osis) vs HTTP (external REST API) - **View enum with FromStr trait**: Complete pattern with parameterized views - **Dual-target service layer**: gloo-net for WASM + native stubs for cargo check - **Tera-to-RSX conversion table**: 15+ template patterns mapped to RSX equivalents - **JavaScript interop**: js_sys::eval patterns for clipboard, audio, syntax highlighting - **Island entry point**: Signal-based navigation (not Dioxus Router) - **Standalone lib.rs boilerplate**: cfg-gated web component registration - **CI/Clippy gotchas**: 6 hard-won lessons from real CI failures - **Complete porting checklist**: 13-point verification list ## Context Based on lessons learned porting hero_books (Tera templates on port 8883) to a native Dioxus island in hero_archipelagos (PR lhumina_code/hero_archipelagos#14). ## Test plan - [ ] Documentation-only changes, no runtime code - [ ] Verify skill renders correctly in Forgejo markdown preview 🤖 Generated with [Claude Code](https://claude.com/claude-code)

mik-tf added 1 commit

2026-02-18 02:54:55 +00:00

docs: comprehensive UI porting guide for archipelagos skill 33bf04833f

Expand the "Porting an Existing UI" section in the archipelagos skill
from a brief checklist into a complete step-by-step guide covering:

- Two porting modes: SDK (hero_osis) vs HTTP (external API)
- View enum with FromStr trait pattern (not inherent from_str)
- Dual-target service layer (gloo-net WASM + native stubs)
- Tera-to-RSX conversion reference table
- JavaScript interop via js_sys::eval
- Island entry point wiring (signal-based navigation, no Router)
- Standalone lib.rs boilerplate with cfg gates
- CI/Clippy gotchas (#[component] _props bug, cfg-gated params,
  rustfmt::skip for generated code, standalone import gating)
- Complete porting checklist

Also update the Dioxus skill to reference the archipelagos skill for
island work, clarifying that islands don't use Router or Server Functions.

Based on lessons learned porting hero_books (Tera templates) to a native
Dioxus island in hero_archipelagos.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>