Settings
Removing a Project
Spruce offers three levels of project removal, escalating in scope. Pick the one that matches your intent.
Remove project modal showing the three removal levels with what each one deletes
1. Spruce only
Removes the project from Spruce's project list, so it no longer shows up in the project switcher or the home screen. Leaves the project folder and any linked code repos untouched on disk. Reopen it later with Open Project and it comes right back.
Best for: temporarily hiding a project you don't want cluttering the home screen.
2. Spruce + data
Removes the project from Spruce and deletes the project folder from your application-data directory. Linked code repos are left alone.
Best for: deleting a project you no longer need, but keeping code repos you may still work on.
This deletes the project's git history along with the folder. If the project was pushed to a remote, you can re-clone it. If it was only local, the data is gone.
3. Spruce + data + repos
Removes the project, deletes the project folder, and deletes any linked code repositories from disk.
Best for: wholesale cleanup of a project you're done with and don't need the code for.
This deletes local checkouts of linked code repos regardless of git state. Uncommitted changes will be lost. Spruce prompts for confirmation and lists every path that will be deleted.
How to remove
Two entry points, depending on whether you're removing one project or several:
- One project: open the project's Settings → General. Scroll to the bottom and click Remove project. Pick a level (the modal above appears) and confirm.
- Multiple projects in one pass: open Spruce settings → Reset. The Reset section lists every project Spruce knows about, with the same three-level removal per row. Useful when you want to clean out a stack of projects at once, or to remove a project whose data is gone but is still in Spruce's list.
Either path opens the same modal and applies the same removal levels; they just differ in scope.
Related
- Open Your First Project — re-adding a removed project via the wizard.
- Per-Project Settings — the full settings page.