Skip to content

Changelog

Each edition of Pauta is a version: a new or stronger rule is a minor version, a new MUST that existing apps fail is a major one, wording and facts a patch. The entries come from the repository’s CHANGELOG.md, in Keep a Changelog form.

1.3.1

Changed

  • American spelling throughout. Color, behavior, gray, license, customize and canceled, in every page, the changelog and the README; the Icons and color page’s address follows (/icons-and-color/). AGENTS.md states the rule.

1.3.0

Added

  • Icons and color, a new Experience page: Inter on every scene and JetBrains Mono for code; the Caret & Ink palette as a swatch grid of each token’s light and dark value; the state vocabulary (amber not durable yet, red broken, green verified, accent an offer, periwinkle the keyboard and nothing else) named once on .root from the theme’s roles, with the contrast rules StyleContrastTest pins; the 28 themes and the separate editor themes; and the two icon families (kit line glyphs stroked, Material glyphs filled), their classes, sizes and licenses, with what each of the six apps does. The checklist gains an Icons and color group and the matrix three rows.
  • Toolbars and tooltips, a new Experience page: an icon-only button gets its tooltip and its accessible name from one helper, stays out of the Tab order and names its command and chord in the tooltip; groups are spaced, not ruled, on one chrome band with the menu bar and the tab strip; a toggle wears :open while its overlay shows; the pinned tail never overflows; and Editora’s customizable toolbar (drag to reorder, drag off to remove, Escape) as a MAY. An annotated mockup and a spec table from Editora’s Icons, ToolbarCoordinator and ToolWindowManager.
  • Tabs and tool panels, a new Experience page. The tab header is a graphic label that carries the states (• and amber italic for unsaved, a pin and bold for pinned, muted italic for read-only, the Git colors), is the drag handle for reordering, and opens into the editor with a three-sided border; bulk close skips pinned tabs and Reopen Closed Tab brings the last one back. Tool panels dock on three stripes, two windows a side, toggled by commands and restored from workspace-state.json, with the SplitPane divider as their only edge. An annotated mockup and a spec table from Editora’s TabHeaders, ClosedTabs, Switcher and ToolWindowManager; Torrenta’s sidebar and detail pane, Mirada’s panels and Termina’s panes beside them.
  • Tray and background, a new Experience page for the apps that keep working without their window: the tray icon (a StatusNotifierItem on Linux, AWT elsewhere, the app’s own mark recolored by state), its text-only menu with the status line first and Quit last, close to tray only while an icon is actually up, --minimized, start at login as the OS’s own entry with nothing beside it, and desktop notifications through one Notifier with one switch per event. From Torrenta’s tray/, os/Autostart and automation/Notifiers, with Modula and nux. The checklist gains a Tray and background group and the matrix two rows.
  • QuickOpen picker template. The palette card with a title and a prompt, for choosing one thing from a list: anatomy, spec (620 px, 26 px rows that hug the matches, 12 before scrolling), behavior (the supplier’s order until you type, the current value pre-selected, preview with an undo, row actions), what each app picks with it, and the strings. From Editora’s QuickOpen, PickerKeys and OverlayHost; Mirada’s CommandPalette.Choices is the same shape.
  • Welcome page template. Editora’s start page as a mockup with its anatomy: Start actions that are commands with their chords, recent projects and files a digit away, Customize, Help and the footer; the spec from WelcomePane, when the page shows and when it does not (the empty-state hint after the last tab), and Torrenta’s drop zone as the empty state for an app with no documents.
  • Confirm dialog, a template. The question before a destructive action: it names the thing and the consequence, the button names the action in red (danger), Cancel is the catalog’s word with Escape behind it, and where an undo exists there is no question. Mockup, the three-answer unsaved-changes variant, a spec tied to Editora’s CloseCoordinator and GitCoordinator.confirmDestructive and Torrenta’s RemoveConfirm, and the strings.
  • Find bar, a template. In-scene and incremental with a count; Enter and Shift+Enter step, Escape closes the bar and gives the keyboard back; the keymap’s caret chords work in the field; big documents and scrollbacks are searched off the FX thread. Editora’s docked find and replace and Termina’s floating card as mockups, Torrenta’s filter box as the list app’s version.

Fixed

  • The palette’s shared parts are named as the code has them. Editora’s caret-key helper is TextInputKeymap (TextInputKeys in Termina’s and Mirada’s copies), and Torrenta shares MatchText only, ranking with its own CommandMatcher; the Command Palette template and Shared features said all four were shared verbatim with all three.

1.2.0

Added

  • Menus, a new Experience page. The menu bar and right-click menus share one look: Inter 14 px rows of 34 px, a 22 px icon column with the command’s own glyph, the chord right-aligned in its own column at 11 px in the keyboard color, radius 8 and a shadow that falls below the card. Right-click menus MUST open one at a time, close on a press anywhere outside them (including inside the control they were opened on, which JavaFX’s auto-hide exempts), close on Escape and open from the Menu key at the selected row. Two annotated mockups, a spec table and the behavior, all from Editora’s MainMenuBar, ContextMenuDismissal, RowContextMenu and LazyContextMenu. The checklist gains a Menus group and the feature matrix three menu rows.
  • What’s new, and a Changelog page. The overview shows the current edition’s changes; the Changelog page lists every edition under its own anchor. Both are rendered from CHANGELOG.md, so there is nothing to keep in step.
  • Its own domain: pauta-project.dev. The old github.io address redirects there.
  • Five more principles, from what the apps already do: speed comes first; never claim what is not true; one source of truth for each fact; separate the decision from the UI, then test it; verify by driving the real app. The principles are now thirteen, in two groups: for the people using the apps and for the people building them. Code quality gates and the checklist follow.
  • Four rules where they belong. Settings: Before adding a setting (one right answer is not a setting; Modula’s car-radio test), never trust a config file (clamp on read, .corrupt.bak), and Secrets stay out of files (the OS keychain or session-only, no UI for dangerous escape hatches). Window shell: a destructive action asks first, its button names the action, and undo beats a question.
  • Principle 3: the UI never waits, and a Performance page behind it: keep the JavaFX application thread free (with the generation-guarded background shape every Editora service uses), coalesce hot-path work, bound memory, build only the first frame before it paints, and measure. The checklist gains a Performance group.
  • A name and a mark: Pauta. Spanish for a guideline, and for the ruled lines on writing paper. The mark (three periwinkle rules and a teal tick on the family’s Ink tile) is the favicon and the site logo; a 1280 × 640 card serves shared links. The README, the PDF and the footer carry the name. Sources and how to re-render them are in branding/.
  • Start from the template. The New app checklist and Repository documents link to adl-desktop-app-template, a GitHub template repository that meets every MUST: a runnable app with its tests, CI and release workflows, and an example of every repository document.

Changed

  • Every content change is an edition. A change to a page bumps the version and gets its changelog section in the same commit; AGENTS.md says so and how.
  • The New app checklist can be ticked. Ticks are kept in the reader’s browser, a line above the groups counts them, and Clear ticks resets them.
  • Principles opens with Editora’s keymap picker instead of repeating the overview’s screenshot.
  • The “not found” dot is easier to see, in dark mode especially: an outline in the muted text color.
  • The README links the new app template and describes the dot and pill conventions as they now work.
  • Levels read the same everywhere. MUST, SHOULD and MAY render as the level pill in prose and lists too (“MUST.”, “(SHOULD)”), not only in table cells; on the site and in the PDF.
  • Rule tables stack on a phone. A table with a Level column turns each row into a card with its level and Editora reference visible, instead of scrolling them off screen.
  • The feature matrix keeps its app row in view while a long table scrolls (wide screens).
  • Screenshot galleries leave no gap. Galleries are two to a row; with an odd count the first screenshot spans the row.
  • The overview is reorganized. The Editora screenshot sits beside the title, with the edition under the actions (side by side from 64rem, so the three actions stay on one row; stacked below that); Where to start and How to read it come before the family, which is now six even tiles with Editora marked as the reference.

Fixed

  • The feature matrix no longer widens the page on a phone. Each matrix scrolls inside its own box, so the header’s search and menu stay on screen.
  • A ”—” outside the feature matrix stays a dash. Only matrix cells become status dots; the Homepage column of “What the apps are” no longer shows a “No” dot for apps without a homepage. The print build does the same.
  • Template mockups fit the column. Where a mockup is wider than the text column (Settings Sync and the Command Palette at laptop widths), it is scaled down to fit and says by how much, instead of being clipped.

1.1.0

Added

  • Visual templates for four shared surfaces: the Command Palette, the About window, the Message Log and the Settings Sync page. Each has an annotated mockup at the apps’ real sizes (light and dark), its anatomy, a spec table tied to Editora’s code, its behavior, its exact strings, and the real screenshots from the apps.

Fixed

  • The palette does not rank recently used commands first. Keyboard first said it did; Editora ranks by match score, with a query that names a title first.

1.0.0

Changed

  • JDK 25 and JavaFX 27 are floors, not ceilings. The platform baseline asks for JDK 25 or newer (an open enforcer range) and JavaFX 27 or newer; the badges read 25+ and 27+.
  • Inter is a SHOULD, not a MUST.
  • Every repository document is a MUST except TODO.md: CONTRIBUTING.md, docs/ and branding/ join the rest. The matrix gains a CONTRIBUTING.md row and the gaps table lists who lacks it; Torrenta and Modula are marked for committing only CLAUDE.md, with no AGENTS.md.
  • The checklist is grouped by area, each group linking to its page, with a hanging indent for wrapped items.
  • The feature matrix fits on the page. Its page is wider and notes under a dot wrap, so all six columns show without scrolling sideways.

Added

  • First edition of the guidelines. Principles, platform baseline, repository documents, quality gates, keyboard-first interaction, window shell, Settings, diagnostics, command line, internationalization, packaging and signing, and a new app checklist — extracted from Editora.
  • The family pages. A feature matrix of Editora, Torrenta, Termina, Modula, Mirada and nux surveyed from each default branch on 2026-11-05, nineteen shared features worth standardizing, and the gaps per app.
  • Screenshots from the apps. 21 captioned figures across Principles, Platform, Keyboard, Window shell, Settings, Diagnostics and Internationalization, and a gallery of the family on the overview. New Editora captures of the Settings search, Message Log, Report a Problem and About; the rest come from the apps’ websites and READMEs. The PDF carries them too, and the single Markdown file links them from the repository.
  • The apps’ own icons. Each app’s icon, copied from its branding/ folder, heads its column in the feature matrix, labels its row in the gaps table, captions its screenshot on the overview, and appears in the PDF and the README.
  • A Mirada screenshot. Mirada showing a folder of wallpapers with its info panel and thumbnail strip, on the overview and on Window shell beside Termina’s title bar.
  • Click a screenshot to see it large. Every screenshot on a page (and in the overview gallery) opens in a full-window viewer with its caption; ← and → step through the page’s screenshots, Esc or a click outside closes it. Screenshots take keyboard focus and open with Enter or Space.
  • Install methods. Packaging, signing and release covers Homebrew (a cask in adriandeleon/homebrew-tap) and winget (AdrianDeLeon.<App>) beside the GitHub release downloads, with what each needs and where each app stands.
  • CI/CD for GitHub Actions as a table of the three workflows and the rules every workflow follows, and as its own group in the checklist.
  • The six languages, as a floor. Internationalization lists them, says apps should add more, and what a new language takes (CJK font fallback, right-to-left orientation).
  • Homepage and GitHub links for every app on the overview and the feature matrix.
  • Repository documents screenshots: Editora’s repository root and the top of its README on GitHub.
  • Web version on GitHub Pages with search, light and dark themes, and PDF and single-Markdown downloads built in the same workflow.

Pauta 1.3.1 · · Changelog