The TUI
Joppa full screen in the terminal: sidebar, projects, services, live logs, command palette, by keyboard or mouse.
joppa with no arguments opens the app full screen in the terminal, with the same visual system as the window:
- the sidebar: projects and services, with their status dot and port;
- the page of the selected item: domains and their health, a service’s status, its databases, its live log;
- the status bar: proxy, CA, domains online, runtime.
Everything refreshes every two seconds. The theme follows the terminal (Nuit or Jour); --theme forces it, T toggles it.
Keys
| Key | Action |
|---|---|
| ↑ ↓ · j k | Move |
| tab | Switch between the sidebar and the page |
| ctrl p · : | The command palette, like ⌘ K in the app |
| p | Start / stop the proxy |
| s | Start / stop the service |
| space | Enable / disable a domain |
| o | Open the domain in the browser |
| c | Copy its URL |
| t | Open in TablePlus |
| n | Create a database |
| a | Add a project (on Projects) or a service (on Services) |
| N | New project from a template |
| T | Toggle the theme |
| esc | Go back one step |
| ? · q | Help · quit |
The mouse works too: click, double-click to open, scroll wheel.
Adding from the TUI
- A project (a): the folder (the current folder by default, tab completes the path), what Joppa detects there (domains to check with space, or to add by hand:
app 5173), then the name. - A service (a on Services): the catalog by category, the version (← →) and the first free port, then the start.
- A new project (N): the template, the name, the parent folder and the options, the commands, then the live creation; esc cancels it.
If the app isn’t running, the TUI says so and offers to launch it (l), then reconnects on its own.