scaffold the app: tauri crate, vite front end, icons, ci

2026-10-02 11:07:06 +00:00 · 2026-09-03 17:01:50 +05:30
commit 088ec9c6e4
@@ -0,0 +1,129 @@
+# Keyboard
+
+One unmodified key per verb, no two-key chords, nothing modal. Where Gmail and Superhuman agree,
+we use their key so a refugee's hands keep working. Where HEY has a verb they do not, we use
+HEY's letter. The three conflicts that result are settled below and explained. The key is printed
+on every button, the palette lists every command with its key, and `?` shows this table in the
+app. Bindings live in a keymap file the user can edit; the defaults are what follows.
+
+## Navigation
+
+| Key | Action |
+|---|---|
+| `j` / `k` | Next / previous thread (or card in the Feed and Screener) |
+| `Enter` | Open the focused thread; with several selected, Read together |
+| `Esc` | Close what is open: a popover, then the palette, then the compose card, then the pane in one-column mode, then the selection |
+| `n` / `p` | Next / previous message inside a thread |
+| `o` / `Shift+O` | Expand or collapse the focused message / expand all |
+| `Space` / `Shift+Space` | Scroll the pane down / up |
+| `1` `2` `3` | Inbox, Feed, Paper Trail |
+| `4` `5` | Reply later, Set aside |
+| `6` `7` | Screener, Snoozed |
+| `0` | Everything |
+| `/` | Search |
+| `Cmd+K` | Palette: places, commands, people, settings |
+| `Ctrl+1` to `Ctrl+9`, `Ctrl+0` | Switch account, All accounts |
+| `Cmd+\` | Show or hide the reading pane |
+| `Cmd+,` | Settings |
+| `?` | This table |
+
+## Triage
+
+| Key | Action | Provider |
+|---|---|---|
+| `e` | Archive | yes |
+| `u` | Toggle seen | yes |
+| `Shift+S` | Toggle star | yes |
+| `#` | Trash | yes |
+| `!` | Spam | yes |
+| `l` | Reply later (toggle) | no |
+| `s` | Set aside (toggle) | no |
+| `b` | Snooze… | no |
+| `y` | Note | no |
+| `m` | Ignore (toggle) | no |
+| `Shift+N` | Notify me on this thread (toggle) | no |
+| `g` | Merge the selected threads | no |
+| `i` | Contact card for the sender | no |
+| `Shift+L` | Label… | yes |
+| `v` | Move to Inbox, Feed or Paper Trail (sets the sender's rule); in a label list, move to a label | rule: no, label: yes |
+| `Cmd+U` | Unsubscribe… | sends or opens |
+| `x` | Select the focused thread | |
+| `Shift+J` / `Shift+K` | Extend the selection down / up | |
+| `Cmd+A` | Select all from here | |
+| `z` | Undo the last action, including a send within its delay | |
+| `.` | More actions for the thread | |
+
+## Screener
+
+| Key | Action |
+|---|---|
+| `y` | Yes, to the suggested place |
+| `v` | Elsewhere: pick the place, optionally for the whole domain |
+| `n` | No, screen out |
+| `Enter` | Expand the card to read the message |
+| `r` | Screen in to Inbox and reply |
+
+## Writing
+
+| Key | Action |
+|---|---|
+| `c` | New message |
+| `r` / `a` / `f` | Reply / reply all / forward |
+| `Cmd+Enter` | Send (held for the undo delay) |
+| `Cmd+Shift+Enter` | Send now, no undo |
+| `Cmd+Shift+P` | Expand the compose card to the window, or back |
+| `Cmd+Shift+A` | Attach |
+| `Cmd+Shift+I` | Instant intro: move the introducer to Bcc and thank them |
+| `Cmd+Shift+H` | Remind me if no reply… |
+| `Cmd+Shift+C` | Save the selected text as a clip (also outside compose) |
+| `Cmd+B` / `Cmd+I` / `Cmd+K` | Bold / italic / link inside the editor |
+| `Cmd+Shift+7` / `8` / `9` | Numbered list / bulleted list / quote |
+| `Cmd+Shift+,` | Discard the draft |
+| `Esc` | Leave the editor, keeping the draft |
+
+## Focus & Reply
+
+| Key | Action |
+|---|---|
+| `Shift+F` | Open Focus & Reply from anywhere |
+| `Tab` / `Shift+Tab` | Next / previous item |
+| `Cmd+Enter` | Send this reply and move on |
+| `Esc` | Back to Reply later |
+
+## Calendar invites
+
+| Key | Action |
+|---|---|
+| `y` / `m` / `n` | Accept / maybe / decline, when an invite card is focused |
+
+## The conflicts, and how they were settled
+
+`a` is reply all in Gmail and Superhuman and Set aside in HEY. Reply all is used every day, so it
+keeps `a`; Set aside takes `s`, which is star in Gmail. Star is a vestige here (the piles do its
+job), so star moves to `Shift+S` and stays reachable.
+
+`l` is label in Gmail and Superhuman and Reply later in HEY. Reply later is a primary verb in this
+app and labels are not, so `l` is Reply later and label is `Shift+L`.
+
+`z` is undo in Gmail and Superhuman and Bubble Up in HEY. Undo is sacred; `z` stays undo. Snooze
+takes `b`, which is Gmail's own snooze key and also reads as Bubble Up for HEY hands.
+
+`m` is mute in Gmail and Ignore in HEY, the same verb, so it is `m`. `y` is a sticky note in HEY
+and a rarely known "remove from view" in Gmail; it is a note here. `g` is HEY's merge; in Gmail it
+begins a chord we do not have, so on its own it merges a selection and does nothing otherwise.
+
+Keys are never reused with a different meaning in a different context, with one exception: `y`,
+`v` and `n` on a Screener card and on an invite card, where the card is the only thing that can
+receive them and the buttons print the letters. HEY reuses `o`, `r` and `i` contextually and it
+is the one thing about its keyboard worth not copying.
+
+## Rules
+
+- Single keys act on the focused thread, or on the selection when there is one.
+- A key that would act on nothing does nothing and shows nothing.
+- Every destructive or hidden action (archive, trash, spam, snooze, pile, screen out, merge,
+  send) produces a toast with Undo, and `z` undoes it.
+- On a phone there are no keys. The same verbs are buttons on the action bar and swipes on rows,
+  and the printed letters disappear.
+- The keymap is a file in the app's data directory; the shortcuts sheet is generated from it, so
+  a remapped key is what the buttons print.