#2153

docs: plan the fix for the squeezed Files folder message

DraftDouglasymlaiwants to merge intofrom

Pull Request

Related Issue

N/A — maintainer-directed work; no linked issue required for this PR.

Description

Draft. This branch only adds the plan, docs/files-page-width-plan.md. The fix will follow on this branch.

Problem

In a Space, open Files and select a folder. The content pane is wide, but the message in the middle ("Use the actions above to open this folder in the file manager or an editor.") shows one word per line, so the page looks as if it does not use its full width.

Cause

The message column uses max-w-md. tailwind.config.js adds named spacing steps (xs–xl), and Tailwind 4 resolves max-w-* from spacing before container sizes, so max-w-md becomes max-width: 16px instead of 28rem. The bundled CSS confirms it: .max-w-md{max-width:var(--spacing-md,16px)}. The same collision squeezes the Spaces empty state, the error card, the Remote Control card, an Automation summary line and side sheets (sm:max-w-sm → 8px).

Fix (planned)

  • Remove the cap from the Folder message, as the design guideline asks for supporting copy.
  • Fix the other call sites: drop the cap on copy, use the owning layout width for containers.
  • Add a check that rejects max-w-{xs,sm,md,lg,xl} in src/, so it does not come back.

Testing

Not started. This branch only adds the plan document, which passes the repository's Prettier check. Testing will follow §5 of the plan.

Testing Evidence (REQUIRED)

  • I have included human-verified testing evidence in this PR.
  • This PR includes frontend/UI changes, and I attached screenshot(s) or screen recording(s).
  • No frontend/UI changes in this PR.

Not yet available: the branch currently contains only the plan document.

What is the purpose of this pull request?

  • Bug fix
  • New Feature
  • Documentation update
  • Other

Contribution Guidelines Acknowledgement

Activity

1

This pull request is a draft

Merging is unavailable until it is marked ready for review.