Workspaces

Connect to multiple Freedom Messenger servers from a single app. Family, work, community — switch between them in one tap.

How Workspaces Work

Each workspace is a connection to a separate Freedom Messenger server. You have one "home" workspace (the server you are currently on) and can add any number of remote workspaces.

• Home workspace — the server hosting the web app you are using. Uses cookie-based authentication.
• Remote workspaces — other Freedom Messenger servers. Each one stores its own server URL, optional label, and JWT token.

Adding a Workspace

1. Use the workspace rail in the sidebar. On desktop, choose the dashed plus button; on mobile, pull down the chat list to reveal the workspace bar when it is hidden.
2. Select "Add Workspace."
3. Enter the server URL (for example, https://team.example.com).
4. Optionally give the workspace a label (like "Work" or "Family").
5. Select "Verify and log in." The app checks the server health endpoint, switches to that workspace, and shows the login screen for that server.
6. Log in with your credentials for that server.

The add workspace dialog traps keyboard focus while it is open. Escape, the backdrop, or the cancel/close control closes the dialog and returns focus to the workspace button you used.

Switching Between Workspaces

Tap any workspace in the switcher to switch to it. Each workspace button is labelled with the workspace name, server, active state, and unread count for screen readers. The chat list, messages, and settings update to show the content from that server.

Remote workspace remove buttons are visible on the workspace icon and can be reached with the keyboard. Removing a remote workspace does not delete data from the server; it only removes that server from this device.

Inactive workspaces are polled every 60 seconds for unread messages. The tab badge (and app badge) shows the total unread count across all workspaces, so you never miss a message.

Exporting and Importing Workspaces

Moving to a new device? Open the Transfer Workspaces action from the workspace rail to export your workspace list as an encrypted string or import one from another device. Export and import controls are regular buttons, so they work with mouse, touch, and keyboard.

Export and import dialogs use the same focus and Escape behavior as the add workspace dialog.

Export

1. Open Transfer Workspaces from the workspace rail.
2. Select "Export."
3. Enter a passphrase — this will be used to encrypt the data with AES-256-GCM.
4. Copy the resulting Base64 string and save it or share it securely with yourself.

Import

1. On your new device, open Transfer Workspaces from the workspace rail.
2. Select "Import."
3. Paste the Base64 string and enter the same passphrase.
4. Your workspaces will be merged with any existing ones on this device.