# Documents, assets, and workspace updates

2026-10-20 · 0.4.4

## TL;DR
- **Documents now support folders**, with the ability to create, rename, move, delete, and bulk-move documents between folders.
- **Board attachments now support files up to 250 MB**, and you can pick a project icon from an existing image asset.
- **Dashboard and project cards show more useful activity context**, including the age of the latest commit.
- **Finder actions and file issue handling are more direct**, including options to reveal items in Finder and clearer guidance when something needs attention.

## Added
### Documents
- Added a sidebar tree for project documents so you can organize notes into folders instead of keeping everything in one list.
- Added document folder actions, including create, rename, move, delete, and move selected documents together.
- Added the ability to link from one project document to another.
- Added multi-selection for documents so you can delete or move several at once.
- Added a document folder picker when importing or creating documents, so new content can go straight into the right place.

### Projects and assets
- Added the option to choose a project icon from one of the project’s image assets.
- Increased the board attachment limit to 250 MB per file. The ten-attachment limit per card is unchanged.
- Added project-asset previews for compatible images in the icon picker.
- Added a star action to document and asset context menus.

### Workspace and Finder
- Added a way to reveal project documents, folders, and file issues in Finder.
- Added a route for checking dependency scans for multiple package roots at once.
- Added support for tracking moved workspace items so Orbit can surface them more clearly during file reconciliation.

### Scratchpad
- Added source note tracking to scratchpad suggestions so you can remove matched notes when applying actions.
- Added a checkbox in the action review flow to remove saved suggestions from the scratchpad after they’re applied.

## Changed
### Dashboard
- Dashboard project cards now show the age of the latest commit, making recent activity easier to spot at a glance.
- Compact dashboard rows now make more room for activity details.

### Projects
- Project cards now separate commit activity from task counts, making the summary row easier to scan.
- Project search and section tabs now stay better aligned in narrower layouts.
- Project boards now show clearer attachment limits and use a lighter title style for cards.
- Project scratchpad suggestions now save without repeating the old “notes unchanged” message.

### Documents
- The document editor now includes a dedicated toolbar action for linking to another document.
- Document previews now show a collapsible contents panel instead of a flat heading list.
- Document navigation now supports folders in the preview and in the document sidebar.

### Assets
- Asset uploads now show clearer status when an upload is blocked and can be retried from the project panel.
- Drag previews for assets are more compact and easier to read.
- Removed the previous 10 MB per-file limit for project assets. Projects still support up to 100 files and 100 asset folders.

### Workspace and file handling
- Managed workspace files are now handled with stricter file checks and clearer recovery flows when items move or change.
- File issue banners now distinguish unsupported document files, moved items, and other file problems with more specific guidance.
- File issue dialogs now offer a direct “show in Finder” action when available.
- Dependency checks can now be queued in bulk instead of checking roots one by one.

### Secrets and backups
- Native secret handling now uses a new sealed storage flow for MCP secrets.
- Restoring a workspace backup now also updates legacy stored secrets during the restore flow when running in the desktop app.

### Interface
- Code-style text now uses a dedicated monospaced font.
- Markdown previews and the project scratchpad got spacing and layout refinements.
- Project section tabs now scroll horizontally when needed instead of wrapping awkwardly.

## Fixed
### Documents
- Fixed document navigation so the contents panel is easier to use and stays within the document area.
- Fixed document and folder operations so document folders are preserved when duplicating a project or importing a workspace archive.
- Fixed document moves and folder deletes so items stay in the expected location after the change.

### Assets and uploads
- Fixed asset uploads so large files and project assets are handled consistently across the workspace.
- Fixed project icon selection so choosing an image asset works as expected.
- Fixed drag previews so assets no longer show oversized previews while dragging.

### Workspace and Finder
- Fixed stale file-move warnings so they clear automatically after the issue is resolved.
- Fixed Finder-related actions so Orbit can show the right item or issue location more reliably.
- Fixed dependency scan queuing so repeated checks do not pile up unnecessarily.
- Fixed workspace actions so tabs and project views stay responsive during common save and refresh flows.

### Scratchpad
- Fixed scratchpad action suggestions so source notes can be removed safely when the matched text is still present.
- Fixed scratchpad previews so linked actions keep their source text when available.

### Miscellaneous
- Fixed release workflow checks and macOS release runner setup behind the scenes.
- Fixed a few cases where project and board updates could fall out of sync with the saved workspace state.
