Files

1.7 KiB

Web Platform Rules

Interaction and layout

  • Keep URLs meaningful and navigable through go_router.
  • Test direct loading of nested routes, refresh, browser back/forward, and history restoration.
  • Do not intercept browser-reserved keyboard shortcuts.
  • Ensure hover interactions have keyboard and touch alternatives.
  • Constrain content width on large monitors.
  • Test browser zoom, narrow viewports, and text scaling.
  • Do not display native desktop window title-bar UI merely because the browser viewport is wide.

Capabilities and permissions

  • Handle downloads, clipboard access, and file selection according to browser permissions and supported APIs.
  • Treat denied permissions, blocked pop-ups, unsupported APIs, and cancelled file selection as recoverable states.
  • Use browser-safe platform adapters rather than assuming native filesystem access.
  • Preserve route state in URLs and avoid storing navigational truth only in memory.

Release requirements

  • Configure hosted fallback behavior so direct nested URLs load correctly.
  • Test supported browsers and the production build, not only the development server.
  • Verify browser security policies, asset paths, service-worker behavior if used, and cache invalidation.
  • Test browser zoom, refresh, direct URLs, history, downloads, clipboard, and file selection.

Smoke-test checklist

  • Load every primary route directly in a new browser tab.
  • Refresh nested routes and verify the expected screen remains addressable.
  • Use browser back and forward controls.
  • Test keyboard, mouse, touch, zoom, and narrow viewport behavior.
  • Cancel and deny file, clipboard, and download actions and verify recoverable feedback.