Add an optional Superhuman-style layout
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 20/100
- Issue type
- Feature
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript
Research direction
The issue links to the frontend implementation in fork PR #29, which is the best starting point for understanding the proposed layout and its tests. Review how the PR adds the optional setting, toolbar choice, keyboard navigation, and command palette while reusing existing MailFlow actions. Done means the layout is opt-in, Comfortable remains the default, mobile layout and theme choice stay separate, and the frontend checks pass; related requests #596 and #737 provide context.
Written by the indexing model from the issue text.
Description
The situation
I built a Superhuman-style layout for people who want to triage mail quickly from the keyboard. I'd like to offer it as an opt-in option in Settings → Appearance → Layout and in the toolbar's layout menu. Comfortable stays the default, the mobile layout is unchanged, and the theme is still a separate choice.
- A narrow navigation rail opens an account and folder drawer. Split-inbox tabs sit above dense, single-line message rows.
- Messages open full width in place of the list.
j/kmove through messages, Enter opens one, and Esc returns to the list. - ⌘K opens a contextual command palette. Archive, snooze, reply, and Undo use MailFlow's existing actions.
Compact and List first are the closest options today, but neither gives me the rail, drawer, and keyboard-first reader together.
Demo
https://github.com/user-attachments/assets/09598309-f981-4d19-97fe-d14e9eb94775
The 43-second walkthrough uses fictional mail. It shows switching layouts, navigating the inbox and reader from the keyboard, opening the command palette, and changing the theme separately.
Implementation
Frontend-only implementation in my fork (PR #29). It adds no backend changes, migrations, or dependencies. Frontend tests, lint, and the production build passed locally; the PR has the test details.
Related requests
- #596 asked for a full-width list where a message opens on its own. List first covers that, and this layout builds on it.
- #737 asks for a narrow account rail next to the folder tree. This layout's rail and folder drawer cover part of that request.
- Dominant language
- JavaScript
- Stars
- 518
- Forks
- 50
- Avg merge
- 4d 45m
- Merged PRs (30d)
- 43
Getting set up
- Ships a Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from maathimself/mailflow
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
maathimself/mailflow#801 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
maathimself/mailflow#784 ·
Maintainers usually reply within 1 day
-
defaultShortcuts tests fail on macOSPossibly taken A pull request linked to this issue is open or already merged. Open
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
maathimself/mailflow#783 ·
Maintainers usually reply within 1 day
-
Stored mail loses blockquote type=cite, so AI actions read Apple Mail and Thunderbird quoted historyOpen
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
maathimself/mailflow#782 ·
Maintainers usually reply within 1 day
-
Difficulty 5/5 Over a week Newbie friendliness 25/100
maathimself/mailflow#798 ·
Maintainers usually reply within 1 day
All issues in maathimself/mailflow
Similar issues
-
enhancement good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
enhancement good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
blixvip/solana-token-meta#17 ·
-
enhancement good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
blixvip/solana-tx-parse#18 ·
-
bug good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
blixvip/solana-rpc-bench#18 ·
-
bug good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 88/100