Workspace. A home page for your org's tools, at the root of your org's address.

The workspace is an app Hub deploys for your org: a tree of pages written in a block editor, pages that open one of your apps, and a live list of every app on your host. It answers at https://<org>.myhub.host, behind your org's login.

hub workspace init

init writes the workspace's source into ./workspace and deploys it. Create workspace on the dashboard does the same without the folder.

Pages

• A document holds headings, text, lists, to-dos, quotes, callouts, code, images by URL, tables and embedded apps. Type / for the block menu.
• An application page shows one of your apps in a frame that fills the page.
• A catalog page lists the apps on your host with their access and status.

Pages nest to any depth, and you order them by dragging in the sidebar. Every page keeps a permanent address, /p/<id>, through renames and moves. Ctrl-K searches titles and text. A deleted page goes to the trash for 30 days.

Everyone who can open the workspace reads every page. A viewer reads only; every other role edits. Keep secrets in the app that owns them, since pages have no permissions of their own.

The whole tree exports as one markdown document, and each page exports on its own.

Upgrades

Hub upgrades a workspace it deployed when a new version ships, keeping your pages. Your pages live in a volume that survives every deploy.

To change the workspace yourself, edit the folder init wrote and deploy it:

hub deploy ./workspace --name workspace

From that deploy on, the workspace is yours and Hub no longer upgrades it. hub app workspace rm keeps the pages unless you pass --delete-data.

What it does not do

No real-time editing together, no comments, and no page history beyond the trash. Images are links, since the workspace stores no uploaded files. One workspace per org.