Skip to content

Make TrueForge UI mobile-friendly - #897

Open
govindavashishtha wants to merge 9 commits into
mainfrom
chore/AGE-2380/make-trueforge-mobile-screen-friendly
Open

govindavashishtha wants to merge 9 commits into
mainfrom
chore/AGE-2380/make-trueforge-mobile-screen-friendly

Conversation

@govindavashishtha

Copy link
Copy Markdown
Contributor

Summary

Makes the sidebar layout usable on small screens with a Claude-style mobile nav drawer, and gates desktop-only surfaces (Build Agent, Sessions, Schedules) behind an informational notice while keeping chat history deep links working.

Closes #AGE-2380

Changes

  • Replace the narrow mobile rail with a ~20rem side drawer: branding, New Chat + Agents Library, recent chat history, and footer Docs / Theme / Settings / profile
  • Hide Build Agent, Sessions, and Schedules from the mobile drawer; keep them on the desktop rail
  • Show a shared "Best viewed on desktop" notice for /build-agent, /sessions, /schedules, /sessions/share/:id, and Agent Details Sessions/Schedules tabs on mobile (URL unchanged; /sessions/:id still opens chat)
  • Inline the hamburger into Agents and Settings page headers on mobile to avoid a double top bar
  • Tweak trueforge light sidebarBg to #FDFEFF

How was this tested?

  • pnpm --filter @truefoundry/trueforge-ui exec vitest run for SidebarLayout / routing / AgentDetailsPage suites
  • pnpm --filter @truefoundry/trueforge-ui typecheck
  • pnpm --filter @truefoundry/trueforge-ui lint

Checklist

  • I have read the contributing guidelines
  • pnpm build, pnpm test, pnpm typecheck, pnpm lint:ci, and pnpm format:check pass locally
  • Tests added/updated where it makes sense
  • No hand-edits to generated code (packages/trueforge-sdk, python/trueforge_sdk, .github/fern/openapi/openapi.json, docs/openapi.json) — fork PRs omit SDK regen; maintainers regenerate after merge
  • Docs / .env.example updated if configuration or behavior changed

Made with Cursor

- Introduced a mobile-friendly sidebar layout with a Claude-style navigation drawer.
- Added a DesktopOnlyNotice component to inform users when accessing Sessions and Schedules on mobile devices.
- Updated the AgentDetailsPage to conditionally render the DesktopOnlyNotice based on the mobile viewport.
- Modified ShellActions and ThreadListContainer to support mobile-specific actions and visibility.
- Adjusted SidebarLayout to display a notice for desktop-only features when viewed on mobile.

This update improves user experience on mobile devices while maintaining desktop functionality.
@changeset-bot

changeset-bot Bot commented Sep 28, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 26eba25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@truefoundry/trueforge-ui Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

- Made the sidebar layout mobile-friendly with a Claude-style navigation drawer.
- Added a desktop-only notice for Build Agent, Sessions, and Schedules on small screens.
- Ensured user message actions remain visible on touch devices, while maintaining hover-only behavior on larger screens.
- Updated the Agents listing to display as cards on mobile devices for improved usability.

These changes enhance the mobile user experience while preserving desktop functionality.
- Added 'panel-left' icon to the IconRegistry for improved icon availability.
- Updated SidebarLayout to use 'panel-left' icon in the mobile navigation button, enhancing the user interface for mobile users.

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

Comment thread packages/trueforge-ui/src/layouts/DrawerLayout.tsx Outdated
Comment thread packages/trueforge-ui/src/layouts/SidebarLayout.tsx
Comment thread packages/trueforge-ui/src/layouts/SidebarLayout.tsx
… library state

- Modified the rendering of the count label in the AgentsLibraryButton component to apply a different text color when the library is closed, enhancing visual feedback for users.
- Introduced `isMobileNavDrawerOpen` utility function to check if the mobile navigation drawer is open.
- Updated `AgentsLibrary`, `AgentDetailsPage`, and `SettingsBuilder` components to prevent the escape key from closing their respective dialogs when the mobile nav drawer is open.
- Enhanced `SidebarLayout` to ensure proper handling of the escape key event for mobile navigation.

These changes improve user experience by ensuring that the mobile navigation drawer can be closed without unintentionally dismissing other dialogs.

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

Comment thread packages/trueforge-ui/src/layouts/DrawerLayout.tsx
- Updated DrawerLayout to conditionally exit create-agent mode only when dismissing the mobile Build Agent notice, preventing unintended closure of dialogs during desktop interactions.
- Added a new test case to ensure that the agent builder remains open when the "Back to chat" action dismisses schedules on desktop, enhancing user experience and interaction consistency.

These changes improve the handling of user actions across different device types.
@govindavashishtha govindavashishtha changed the title Make TrueForge UI mobile-friendly with Claude-style nav drawer Make TrueForge UI mobile-friendly Sep 30, 2026

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit ac5db63. Configure here.

Comment thread packages/trueforge-ui/src/layouts/SidebarLayout.tsx
…friendly

Co-authored-by: Cursor <cursoragent@cursor.com>
@govindavashishtha
govindavashishtha enabled auto-merge (squash) October 4, 2026 18:11

This branch has not been deployed

No deployments
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