Interface

Postguy is one window. It has a header on top, a sidebar on the left, a tab strip with the active document in the middle, and a bottom bar. The default window size is 1280 x 800. The minimum is 900 x 560.

Header

• The workspace name is the folder name of the open workspace. See Workspace for how the folder is chosen.
• The back and forward arrows are there but disabled.
• Search Postguy opens the command palette (also Cmd/Ctrl+K).
• The gear opens the Settings tab. See Settings.
• On macOS the header doubles as the title bar, and the menu bar is the native one. On other systems the menu row is drawn inside the header.

Welcome screen

With no tab open, the central panel shows New HTTP request, Import… and Settings…. It also shows this reminder: Cmd/Ctrl+N new request · Cmd/Ctrl+I import · Cmd/Ctrl+K commands.

Sidebar

• The three sections have collapsible headers and draggable splitters between them.
• Section open state and heights are saved in the session file.
• Drag the sidebar's right edge to change its width (180 to 520 points).
• The Console's top edge and the code snippet panel's left edge resize the same way.
• These sizes are kept while the app runs, not between sessions.

Collections

• The tree shows collections, folders and requests. Requests show a method label: GET, POST, PUT, PATCH, DEL, HEAD, OPT, gRPC or WS.
• The caret expands folders. For a request with saved examples, it expands the examples.
• Click a row to open it in a tab. Enter opens the focused row. Opening a document that is already open just activates its tab.
• The filter field (Filter) matches request and environment names, the method label and the URL of HTTP requests. While a filter is active, the tree shows only matches and their parents.
• The + button opens New…:
  • New HTTP request
  • New gRPC request
  • New WebSocket request
  • New collection
  • New environment
  
  The request items are enabled when a collection or folder is selected. The import button opens the import dialog.
• The hover ... button and a right-click open the same context menu. See Collections for the actions.

Environments

The list has one row per environment. The active environment is marked. The context menu has Set active, Rename, Duplicate, Export, Delete and No environment.

History

Every send from the request builder adds a row, newest first. A row shows the method, the URL, the time, the status and the duration. The filter also matches the time text and the history id. The context menu has Open and Delete.

Keyboard and mouse

These keys only work while no text field has focus.

Tab strip

• Each open document gets a tab: request, environment, globals, collection, folder, settings, cookies, trash or runner.
• A dot on a tab means unsaved changes. It turns into the close button on hover. Closing such a tab opens Unsaved changes with Cancel, Don't save and Save.
• Middle-click closes a tab. Drag a tab to reorder.
• Cmd/Ctrl+W closes the active tab.
• Cmd/Ctrl+Shift+T reopens the last closed tab.
• Cmd+Tab / Cmd+Shift+Tab move to the next or previous tab.
• The chevron button (Search tabs) lists Open tabs and Recently closed. Postguy keeps the last 20 closed tabs. The menu shows 10.
• Tabs and layout are restored on the next start. See Workspace.

Environment selector and Vars

Both sit at the right end of the tab strip.

• The selector shows the active environment or No environment. Its menu has a search field, No environment, the list and + Create new environment. Your choice applies to every request.
• Vars (the eye button) opens a quick look at the variables of the active environment, the globals and the collection of the active request. Secret values are masked until you press Reveal secrets. Click a value to copy it.

See Variables.

Request and response layout

• By default the builder is on top and the response viewer is below it.
• Two-pane (bottom bar, Cmd/Ctrl+Alt+V) puts them side by side.
• Drag the divider between the builder and the response to share the room differently. Each layout keeps its own divider position while the app runs.
• Neither the layout toggle nor the divider position is saved between sessions.

Bottom bar

The runner has no bottom-bar button. Open it from a collection or folder (Run) or with the command Open collection runner. See Collection runner.

Console

The console panel shows what the engine did: requests, script console.* output, warnings and errors.

• Filters: All, Requests, Logs, Warnings and Errors.
• It also has a search field, a Timestamps switch and Clear.
• It keeps the newest 5000 entries from the last 24 hours.
• Secret values are masked.

Command palette

Open it with Cmd/Ctrl+K (when no text field has focus) or the header search button.

• Type to filter. Matching is a case-insensitive subsequence match.
• The list shows open tabs, recently closed tabs, collections, folders, requests and environments first, then commands. A > prefix limits the list to commands.
• At most 12 results are shown.
• Up / Down move, Enter runs, Esc closes.
• Commands show their group and shortcut as a hint.

The full command list and every shortcut is in Keyboard shortcuts.

Menus

The menus File, Edit, View, Window and Help run the same commands as the palette.

• On macOS they live in the native menu bar. On Windows, Linux and FreeBSD they are the in-app row in the header.
• The Window menu has placement commands (halves, quarters, thirds, fill, center).
• Help › Documentation opens this site.

Themes and zoom

• Settings › Themes has Dark, Light and System. System follows the operating system.
• Interface zoom scales the whole UI from 80% to 200%. Cmd/Ctrl+=, Cmd/Ctrl+- and Cmd/Ctrl+0 zoom in, out and reset. See Settings.
• Poppins is the one embedded UI font. Code uses a monospace face at the Code font size setting (9 to 24 px).