editor basics

workspaces

a workspace is a folder you’re working in. switch workspaces with ⌘O / ctrl+O or by clicking the sidebar header.

your home folder (~/.spacecake) is always available for notes that aren’t tied to a specific project.

sidebar

the sidebar shows your workspace file tree. toggle it with ⌘B / ctrl+B.

folders load their contents on demand when you expand them. the current open file is highlighted.

file operations

right-click a file or folder to access the context menu:

files:

• rename
• delete
• revert (if the file has unsaved changes)

folders:

• new file
• new folder
• rename
• delete

use the + button at the top of the sidebar to create a new file or folder relative to the current selection in the tree.

renaming selects the filename without the extension, so you can quickly type a new name and press enter. press escape to cancel.

files and tabs

• quick open: press ⌘P / ctrl+P to search and open files by name
• new file: press ⌘N / ctrl+N to create a new file
• close tab: press ⌘W / ctrl+W or click the × on the tab
• save: press ⌘S / ctrl+S to save the current file
• save all: press ⌘⇧S / ctrl+shift+S to save all open files

tabs show open files at the top of the editor. scroll horizontally if you have many tabs open.

if a file is modified outside spacecake while you have unsaved changes, you’ll see a conflict indicator. you can choose to keep your changes or discard them and reload from disk.

autosave

spacecake can automatically save files as you edit. enable autosave in workspace settings:

1. click the gear icon in the sidebar
2. toggle enable autosave on

when enabled, changes are saved to disk automatically.

themes

toggle between light and dark mode using the theme button in the status bar. the theme persists across sessions.

note: the terminal theme is locked when each tab is created. see troubleshooting if the terminal doesn’t match after switching themes.

panels

spacecake has three panels — terminal, git, and tasks. each panel can be docked to the left, bottom, or right of the editor.

default positions:

panel	default position
terminal	right
git	left
tasks	bottom

toggling panels

click the panel toggle buttons in the status bar to show or hide each panel. collapsing a panel preserves its state — the terminal keeps running, git status stays loaded.

changing dock positions

there are three ways to move a panel to a different dock position:

• layout switcher — click the grid icon in the status bar to open a visual layout editor. click a panel in the list, then click a dock zone (left, bottom, or right) on the minimap to move it. you can also toggle panel visibility with the eye icon next to each panel. click restore defaults to reset all panels to their default positions.
• right-click — right-click any panel toggle button in the status bar to choose a new dock position from the context menu.
• settings — open workspace settings and go to the layout tab to configure panel positions using the same visual editor.

drag the panel edge to resize it.

see the keyboard shortcuts page for a complete shortcut reference.