geomind_code/dev_docs
22
0
Fork 0
Code Issues 10 Pull requests 1 Projects Releases 2 Packages 1 Wiki Activity Actions

docs: comprehensive UI porting guide for archipelagos skill #19

Closed
mik-tf wants to merge 1 commit from development_archipelago_porting_guide into development
pull from: development_archipelago_porting_guide
merge into: geomind_code:development
Conversation 0 Commits 1 Files changed 2 +423 -15
mik-tf commented 2026-02-18 02:54:54 +00:00
Member
Copy link

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)
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>
mik-tf closed this pull request 2026-02-18 03:00:11 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
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.

Dependencies

No dependencies set.

Reference
geomind_code/dev_docs!19
No description provided.