Skip to content

Conversation

@tonybentley
Copy link
Contributor

@tonybentley tonybentley commented Jan 11, 2026

Summary

  • Display TypeDoc API documentation in an iframe within the admin UI instead of opening in a new browser tab
  • Users can browse documentation while maintaining access to the admin navbar and sidebar navigation
  • Original /documentation/ endpoint remains accessible for direct access

Changes

File Change
EmbeddedDocs.js New component with responsive iframe (calc(100vh - 55px))
Full.js Add /documentation route before login route
Sidebar.js Change Documentation link from external (target: '_blank') to internal route

Validation Evidence

Comprehensive browser automation testing was performed with 14 screenshots captured:

Baseline (Before Changes)

  • T001: Admin UI dashboard loads correctly
  • T002: Documentation link opens in new tab (old behavior)

Core Feature Validation

  • T006: Embedded docs display with navbar and sidebar visible ✓
  • T007: Admin navigation (Dashboard, logo click) works from docs view ✓
  • T008: TypeDoc internal navigation works within iframe ✓
  • T009: Browser back/forward navigation works ✓

Direct URL & Compatibility

  • T010: Direct URL admin/#/documentation loads correctly ✓
  • T011: Original /documentation/ URL still works standalone ✓

Responsive & Edge Cases

  • T012: Responsive at 800x600 and mobile (375x667) ✓
  • T013: Wide content (API docs) displays with proper scrolling ✓

Build Verification

  • T014: npm run build completes with no errors ✓

Test Checklist

  • Click "Documentation" in sidebar → docs display within admin UI
  • Admin navbar remains visible when viewing docs
  • TypeDoc navigation links work within iframe
  • Click another sidebar item → navigates away normally
  • Browser back button → returns to previous page
  • Direct URL admin/#/documentation → loads correctly
  • Window resize → iframe resizes appropriately
  • Original URL /documentation/ → still works

Screenshots

Screenshots were captured during automated testing. Key validations:

  1. Embedded view: TypeDoc content displays within admin UI frame with full navbar/sidebar
T006-embedded-docs
  1. Responsive: Layout adapts correctly from mobile (375px) to desktop (1280px)
T012-responsive-800x600 T012-responsive-mobile
  1. Navigation: All internal TypeDoc links stay within iframe, admin navigation unaffected
T009-back-navigation

🤖 Generated with Claude Code

Display TypeDoc API documentation in an iframe within the admin UI instead
of opening in a new browser tab. Users can now browse documentation while
maintaining access to the admin navbar and sidebar navigation.

Changes:
- Add EmbeddedDocs component with responsive iframe
- Add /documentation route in Full.js
- Update Sidebar.js to use internal route instead of external link

The original /documentation/ endpoint remains accessible for direct access.

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@tkurki tkurki added the feature label Jan 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants