Skip to content

Add the app-shell archetype + reveal/loading defaults (v0.6.0) - #55

Merged
kurenn merged 1 commit into
mainfrom
skill/app-shell-archetype
Jul 31, 2026
Merged

Add the app-shell archetype + reveal/loading defaults (v0.6.0)#55
kurenn merged 1 commit into
mainfrom
skill/app-shell-archetype

Conversation

@kurenn

@kurenn kurenn commented Jul 31, 2026

Copy link
Copy Markdown
Owner

First-class support for the most common prototype shape (tools, consoles, dashboards), plus two motion/loading defaults — all surfaced by dogfooding the agent-console build.

App-shell archetype

  • build.md — app-shell is now a documented baseline archetype: top bar + optional rail + inner-scrolling main + pinned footer/composer, with the two gotchas that break it (390px top-bar overflow → rule 37; control-bar clearance).
  • styles.css — a .proto-app-shell helper (full-100dvh flex column) + a --proto-controls-safe token, so a pinned composer/footer never hides under the floating control bar. This is the exact collision the console build hit.

Motion / loading defaults

  • Scroll-reveals are a default for brand/expressive landings.reveal on major sections so the page animates in; a static-scrolling landing reads as unfinished for that register.
  • The Loading control auto-hides when nothing is replayable (loading.js + UI.hasLoaders()) — no [data-skeleton-on-load] region and no registered loader → the ⟳ Replay + Speed control hides itself instead of sitting inert. Re-shows if a loader registers later.

Verified

  • Loading auto-hide tested live: visible on the console (registers a loader), hidden on Runs/Settings (nothing to replay).
  • Scaffold JS valid; SKILL.md untouched (2598/2600); additive (+75/−5).

🤖 Generated with Claude Code

First-class support for the most common prototype shape, plus two motion/loading
defaults that were being left on the table.

- build.md: app-shell documented as the baseline archetype (top bar + rail +
  inner-scrolling main + pinned footer), with the two gotchas — 390px top-bar
  overflow (rule 37) and control-bar clearance.
- styles.css: `.proto-app-shell` helper + `--proto-controls-safe` token, so a
  pinned composer/footer never hides under the floating control bar (the collision
  the agent-console dogfood surfaced). vh→dvh fallback.
- Scroll-reveals are now a default for brand/expressive landings (build.md).
- Loading control auto-hides when there's nothing to replay (loading.js +
  UI.hasLoaders()) — no skeleton region and no registered loader → hide it instead
  of sitting inert. Verified: visible on the console, hidden on Runs/Settings.

SKILL.md untouched (2598/2600).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@kurenn
kurenn merged commit e41336f into main Jul 31, 2026
1 check passed
@kurenn
kurenn deleted the skill/app-shell-archetype branch July 31, 2026 23:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant