Workspaces

A workspace is Octarine's top-level container. Each workspace is an independent folder on disk containing your notes, daily entries, and attachments. You can have multiple workspaces — for example, one for personal notes and another for work.

Creating a New Workspace

You can create a workspace during onboarding or later from the Command Bar (pull down and search for "Switch Workspace") or from Settings > Switch.

[[clipboard-1776237864477.png|308]]

When creating a workspace you choose:

Name — displayed in the settings header and workspace chooser. The first letters form the avatar.
Color — a background and border color for the avatar.
Storage location:
- On my iPhone — local device storage.
- iCloud Drive — synced via iCloud across your Apple devices.
- Dropbox — synced via your Dropbox folder.

Three starter notes (Welcome, today's daily note, and a weekly note) are generated automatically in every new workspace.

Switching Between Workspaces

There are two ways to switch:

Command Bar — pull down from the top of any screen, type "Switch Workspace", and select from the submenu listing your other workspaces.
Settings — go to Settings and tap Switch next to the workspace name at the top.

Both take you to the workspace chooser, where you can pick an existing workspace or create a new one.

Workspace Discovery

When you open the workspace chooser, Octarine scans your device's Octarine folders for workspace directories it hasn't seen before. Discovered workspaces appear in the list alongside your existing ones, showing the storage location (phone, iCloud, or Dropbox) with an icon on the right side.

If no workspaces are found, the screen shows a message and a button to create one.

[!INFO]
All workspaces MUST be created in the dedicated Octarine folder in either of on device storage / iCloud / Dropbox. Octarine can’t access folders outside of these folders. When you uninstall the app, iOS automatically deletes the Octarine folder from on device storage, so please make sure of keeping a backup so you don’t lose your notes. This is not the case with the cloud solutions.

Deleting a Workspace

Go to Settings > Delete Workspace at the bottom of the settings page (under "Danger Zone"). This permanently removes the workspace from Octarine. This deletes all notes and folders and the workspace folder from the device/iCloud/Dropbox.

[!WARNING]
This is a destructive action. Please make sure you understand the consequences

You'll see a confirmation screen with the workspace name and a warning before the delete button becomes active.