kubeflow / kubeflow/notebooks

Workspaces UI does not adapt cleanly to narrow browser widths

Open
#1,395 2 comments 0 reactions 0 assignees View on GitHub
area/frontend area/v2 kind/bug priority/needs-triage
Dominant language
No language data
Stars
84
Forks
149
Avg merge
5d 15h
Merged PRs (30d)
29

Description

### Checks

- [x] I have searched the [existing issues](https://github.com/kubeflow/notebooks/issues).
- [x] My issue is related to one of the components in the [`kubeflow/notebooks`](https://github.com/kubeflow/notebooks) repository.

### Kubeflow Notebooks Version

notebooks-v2

### Kubeflow Platform

Local Notebooks v2 development environment using Tilt + kind

### Kubernetes Distribution

kind v0.31.0 go1.25.5 linux/amd64

### Kubernetes Version

```shell
Client Version: v1.35.0
Kustomize Version: v5.7.1
Server Version: v1.35.0
```

### Description

While testing the Notebooks v2 Workspaces UI, I noticed that several layouts become difficult to use when the browser window is narrowed.

This can happen during normal desktop/laptop use, for example when using split-screen windows, side-by-side documentation, browser DevTools, or simply resizing the browser.

At full desktop width (~1440px), the layout works well. At narrower widths, parts of the Workspaces and WorkspaceKinds UI remain desktop-oriented and become heavily compressed.

### Current behavior

At ~768px:

- The Create Workspace form and Summary remain side-by-side, leaving limited space for the form.
- Stepper labels wrap heavily.
- Opening WorkspaceKind details compresses the table significantly.
- Table headings and row content become difficult to scan.

At ~425px:

- WorkspaceKinds columns are compressed into very narrow areas.
- Descriptions wrap excessively.
- Long values and URLs in the details view can overflow or become clipped.
- Workspaces toolbar and pagination become cramped.

At ~1440px:

- The layouts behave as expected and provide the desktop baseline.

### Steps to reproduce

1. Open the Notebooks v2 Workspaces UI through Kubeflow Central Dashboard.
2. Open Workspaces, WorkspaceKinds, and Create Workspace.
3. Open a WorkspaceKind details drawer.
4. Resize the browser window and compare the UI at approximately:
- 1440px
- 768px
- 425px

### Expected behavior

The Workspaces UI should remain readable and usable when the browser window is narrowed, without desktop layouts becoming heavily compressed.

### Proposed direction

Use existing PatternFly responsive layout, table, and drawer patterns where appropriate, while preserving the current MUI / Central Dashboard integration.

The goal would be to improve narrow-window behavior without changing the desktop experience.

I would be happy to work on this if the scope makes sense.

### Acceptance criteria

- [ ] Workspaces and WorkspaceKinds remain usable when the browser is narrowed.
- [ ] WorkspaceKinds columns do not become unreadably compressed.
- [ ] Opening WorkspaceKind details does not make the underlying layout unusable.
- [ ] Long values and URLs remain contained.
- [ ] Create Workspace adapts cleanly at narrower widths.
- [ ] Filters, actions, and pagination remain accessible.
- [ ] Existing desktop behavior is not regressed.
- [ ] Changes remain compatible with PatternFly and the MUI/Central Dashboard integration.



### Screenshots

#### 1440px desktop

Click to see screenshots

Workspaces UI at 1440px desktop viewport

WorkspaceKinds UI at 1440px desktop viewport

Create Workspace UI at 1440px desktop viewport


#### 768px tablet

WorkspaceKind details at 768px tablet viewport

Click to see more screenshots

Workspaces UI at 768px tablet viewport

WorkspaceKinds UI at 768px tablet viewport

Create Workspace UI at 768px tablet viewport


#### 425px mobile

Notebooks v2 mobile responsive layout at 425px

Click to see more screenshots

Workspaces UI at 425px mobile viewport

WorkspaceKinds UI at 425px mobile viewport

WorkspaceKind details at 425px mobile viewport

Create Workspace UI at 425px mobile viewport

### Relevant Logs

```shell
N/A - this appears to be a frontend responsive-layout issue. No
Kubernetes/backend errors were observed while reproducing it.
```

Contributor guide

Open the contributing guide

Research direction

Start by opening the Workspaces, WorkspaceKinds, WorkspaceKind details, and Create Workspace views at the reported 1440px, 768px, and 425px widths. Inspect the existing PatternFly responsive layout, table, drawer, and MUI/Central Dashboard integration used by those views; done means the listed controls, content, URLs, and layouts remain usable without regressing the desktop baseline.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
design, frontend, web-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.