Skip to content

Welcome page

SHOULD in an app that opens files or projects: the page shown when there is no session to restore, and the answer to “what do I do now?”. An app whose window is its content shows its own empty state instead, with the same ingredients (Torrenta’s drop zone, below). Reference: Editora’s ui/WelcomePane.java, with the text rules in ui/WelcomeText.java and the strings under welcome.*.

  1. 1Identity. The app icon at 64 px beside the name (2.4 em, bold) and the README's one-line tagline, muted. One centred column, at most 640 px wide and never narrower than 340; a longer window scrolls.
  2. 2Start actions, each an existing command: New File, Open File, Open Folder as a Project (only with Projects on), Clone Git Repository (only with Git on), and the Command Palette always last, the gateway to everything else. Accent links with no box; the icon sits in a 26 px column so every label starts at the same x, and the whole row answers a click.
  3. 3Chord, right-aligned past a 32 px gap, in the keyboard colour, from the active keymap. Unbound: no chord. Open File shows find-file's chord in the Emacs keymap, where that is the key to learn. The hovered row tints and the chord becomes a chip.
  4. 4Entry number. The first nine recent entries, projects first, are numbered in the keyboard colour; typing that digit opens the entry. Projects come in the order of their most recent file.
  5. 5Recent file row. The name keeps its width; a chip names the project (or the host of a remote file); the folder is muted, relative to the project root, with ~ for home, and elides from its start so the part that differs stays visible. The full path is the row's tooltip; right-click offers Copy Path and Remove from recent files.
  6. 6Disclosure. Five rows per list; the rest wait behind "Show N more", which becomes "Show fewer".
  7. 7Customize. The active keymap and app theme by name; each link runs the picker command. Under an Emacs-style keymap a caption explains the notation. On a first run, with nothing recent, this block moves up under Start.
  8. 8Help and footer. Documentation, What's New (the release notes) and the Doctor. Then the version, the home page and the licence; a dev build adds its commit on its own line once the lookup, which runs git off the FX thread, has answered.
PropertyValueReference
KindA real tab content in its own closeable “Welcome” tab, so the tab strip handles switching and closing; not an overlayWelcomePane implements TabContent, MainController.addWelcomeTab
Column640 px max, 340 px min, 48 px margin, centred in a scroll pane; below the minimum the page scrolls sidewaysCOLUMN_WIDTH, MIN_COLUMN_WIDTH, MARGIN
ZoomEvery px size is multiplied by the text zoom and the fonts are em, so zoom scales the layout, not only the wordssetFontScale, .welcome-*
Surface-color-bg-default, the UI surface, not the editor’s; its tab takes the same fill.welcome-pane, .ui-surface-tab
HeaderIcon 64 px; title 2.4 em bold; tagline -color-fg-muted.welcome-title, .welcome-caption
Section heading1.15 em bold, padding 28 0 8 0.welcome-section
LinksHyperlink in -color-accent-fg, no border, underlined only on hover or keyboard focus; visited stays the accent.welcome-action, .welcome-link
Action rowIcon column 26 px, gap 12 to the label, at least 32 px to the chord; hover fills -color-bg-subtle with 6 px radius, insets 8 px past the rowWelcomePane.action, .welcome-action-row
Chord-state-key, 0.9 em; on hover a -state-key-bg chip, radius 4.welcome-key
Recent rowNumber -state-key 0.8 em; folder -color-fg-muted 0.9 em with a leading ellipsis; project chip muted on -color-bg-subtle, radius 3.welcome-entry-number, .welcome-recent-dir, .recent-project-name
Lists5 rows, then a flat disclosure buttonCOLLAPSED_RECENT_LIMIT, addCollapsed
FocusThe first recent entry, or New File when there is none, with no focus ring; Enter and Space open itrequestFocus, focusPage
  • Shown at startup when there is no session to restore (so always with --no-session), by the view.welcome command (Help → Welcome Page), and when the tab strip is empty after a project swap (showWelcomeIfNoTabs). Standalone diff startup suppresses it while its worker reads the files.
  • Closing the last file tab does not bring it back. The editor area shows its own quiet hint instead: Open File, Open Folder, Command Palette and Welcome Page, each with its chord (EditorEmptyState), and takes focus so chords still reach the window.
  • Rebuilt on every show (refresh), so the recents, the Projects and Git toggles, the keymap and the theme are current. A refresh keeps the focus where it was.
  • Recent lists tell the truth. A file that no longer exists is not offered (RecentFiles.showable, the same filter as the toolbar’s dropdown); remote files are kept unchecked. A project whose root is gone is dropped. Remove from recent files asks first, through the caller, then refreshes.
  • Digits 1 to 9 open the numbered entries: typed characters only, with no modifier, so chords and Enter are untouched (onKeyTyped).
  • Remote Sites appear as their own section when saved SFTP sites exist; a click opens the connection form prefilled.
  • Customize runs keymap.select and theme.setAppTheme; a change made there re-renders the page, chords included.
  • The Welcome tab is not a document: its menu is Close only, no Save, Rename or Pin, and the title bar shows the app or project name, not a file.
KeyEnglish
welcome.tabWelcome
welcome.taglineA keyboard-driven programmer’s editor
welcome.startStart
welcome.newFile / welcome.openFileNew File / Open File…
welcome.openFolder / welcome.cloneOpen Folder as a Project… / Clone Git Repository…
welcome.recentProjects / welcome.recentFiles / welcome.remoteRecent Projects / Recent Files / Remote Sites
welcome.noRecentNo recent files yet. Open a file or a folder to start, or run editora FILE in a terminal.
welcome.recent.showMore / welcome.recent.showFewerShow {0} more / Show fewer
welcome.entryNumberPress {0} to open (accessible help)
welcome.customize / welcome.keymap / welcome.themeCustomize / Keymap / Theme
welcome.notation.emacsChords use Emacs notation: C- is Ctrl, M- is Alt, S- is Shift. Pick another keymap above to see your platform’s notation.
welcome.help / welcome.documentation / welcome.whatsNew / welcome.doctorHelp / Documentation / What’s New / Doctor: Check External Tools
welcome.versionVersion {0}
welcome.pageWelcome Page (the menu item)
Editora's Welcome tab
Editora: Start actions with their chords, Recent Projects and Recent Files numbered 1 and 2, Customize below.

Torrenta has no documents to come back to, so its welcome is an empty state over the table until the first torrent (ui/Welcome.java, bound to the list being empty): a drop zone that says “Drop a .torrent, a magnet or a link anywhere”, the four keys that matter with their chords (open a .torrent file, add what is on the clipboard, filter or run a command, Settings), the clipboard’s magnet or link offered with an Add it button when there is one, and where downloads go with a change link. Nothing on it takes focus: the keys are the way in. Termina, Mirada, Modula and nux open straight into their content and have neither.

Pauta 1.3.0 · · Changelog