Skill feedback
Type: discrepancy
Skill file + section: references/testing.md → Previewing the UI with an emulated host
What the skill says: "/preview: a themed host that ... speaks the full bridge — it posts trek:context with light/dark + accent + appearance toggles"
What actually happens / what's missing: The posted trek:context carries no viewport field, so a page/trip-page plugin is never put in fill mode in /preview (the kit never sets
data-fill). A UI that follows client-bridge.md §5 (root height:100%, inner scroll) collapses to the iframe's 120px min-height; shot then photographs a cropped frame. Worth either
sending viewport: {surface, formFactor, fill, insets} from /preview for page/trip-page types, or stating in testing.md that /preview is always a reporting surface and fill must be
keyed off data-fill.
Evidence: source-read | trek-plugin dev
Citation / repro: trek-plugin-sdk 1.7.0 dist/cli/dev.js, preview() → ctx() builds the context without viewport; scaffold create x --type trip-page, set
html,body{height:100%} + flex root, open /preview → frame is ~120px.
TREK version: unknown
trek-plugin-sdk version: 1.7.0
OS (if tooling-related): Ubuntu 26.04 on WSL2
Generated by the trek-plugin-dev skill.
Skill feedback
Type: discrepancy
Skill file + section: references/testing.md → Previewing the UI with an emulated host
What the skill says: "/preview: a themed host that ... speaks the full bridge — it posts trek:context with light/dark + accent + appearance toggles"
What actually happens / what's missing: The posted trek:context carries no
viewportfield, so a page/trip-page plugin is never put in fill mode in /preview (the kit never setsdata-fill). A UI that follows client-bridge.md §5 (root height:100%, inner scroll) collapses to the iframe's 120px min-height;
shotthen photographs a cropped frame. Worth eithersending
viewport: {surface, formFactor, fill, insets}from /preview for page/trip-page types, or stating in testing.md that /preview is always a reporting surface and fill must bekeyed off data-fill.
Evidence: source-read | trek-plugin dev
Citation / repro: trek-plugin-sdk 1.7.0 dist/cli/dev.js,
preview()→ctx()builds the context withoutviewport; scaffoldcreate x --type trip-page, sethtml,body{height:100%}+ flex root, open /preview → frame is ~120px.TREK version: unknown
trek-plugin-sdk version: 1.7.0
OS (if tooling-related): Ubuntu 26.04 on WSL2
Generated by the trek-plugin-dev skill.