RocketChat / RocketChat/Rocket.Chat

[UI] Home Page layout overflows horizontally on small mobile screens (<360px)

Open
#38,382 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
46.1k
Forks
13.9k
Avg merge
3d 3h
Merged PRs (30d)
130

Description

The Home Page layout breaks on small mobile viewports (e.g., iPhone SE, 320px width). A horizontal scrollbar appears, and "white space" is visible on the right side when scrolling, breaking the dark theme background.

This seems to be caused by the "Add users" or "Create channels" cards having a fixed or minimum width that exceeds the viewport width when combined with margins/padding.

Steps to reproduce:
Open Rocket.Chat in a browser.

Open DevTools (F12) and toggle the "Device Toolbar".

Set the width to 320px (or select "iPhone SE" / "Galaxy S5" preset).

Navigate to the Home / Welcome screen.

Observe that a horizontal scrollbar appears at the bottom.

Scroll to the right to see the overflow and broken background.

Expected behavior:
The content should fit 100% of the viewport width. Cards and buttons should stack vertically or resize fluidly without forcing a horizontal scroll.

Actual behavior:
The layout overflows the viewport width, causing "layout thrashing" and exposing the white background on the right side (in Dark Mode).

Screenshots/Video:

// image 1
Image

// image 2

Image

https://github.com/user-attachments/assets/ea85617e-891a-460f-8527-27b6da1e7530

Version of Rocket.Chat Server: Latest develop branch

License Type: Community

Operating System: Linux (GitHub Codespaces)

Deployment Method: Local Development / Docker

NodeJS Version: v14.x / v16.x (Standard Dev Environment)

MongoDB Version: Latest

Client Setup Information
Desktop App or Browser Version: Chrome / Edge (DevTools Mobile View)

Operating System: Windows / Linux

Additional context
This impacts accessibility and usability for users on smaller legacy devices (iPhone SE 1st Gen, older Androids).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the Home / Welcome screen at 320px in Chrome DevTools, then inspect the "Add users" and "Create channels" cards for fixed widths, minimum widths, margins, or padding that exceed the viewport. Done means the content fits the viewport without a horizontal scrollbar and the dark theme background remains visible when scrolling.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
accessibility, frontend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.