Documentation

Deckspace lets you group files from anywhere on your computer into project workspaces, without moving them. Available on Windows and macOS.

Three things to know

Project

A top-level group. Think: a client, a vessel, a research topic.

Deck

A workspace inside a project. Think: a phase, a discipline, a deliverable.

Portal

A shortcut to a file or folder on your computer. The original stays where it is.

Core features

1

Create a Project

Click the + button at the top of the sidebar. Give it a name and pick a colour.

The colour cascades to all decks inside it, so you can tell projects apart at a glance without reading.

2

Create a Deck

Right-click a project in the sidebar and select New Deck in [Project Name]. Name the deck.

It inherits the project colour, stepping slightly lighter or darker so decks within the same project are still visually distinct. You can have as many decks as you need — split by phase, discipline, deliverable, or whatever matches how you work.

3

Portal a file

Open the File Explorer panel on the right. Navigate to any file or folder — including OneDrive, network drives, and mapped drives.

Windows

Hold Ctrl and drag the file onto the deck. A portal appears. The original file has not moved.

macOS

Hold ⌘ Cmd and drag the file onto the deck. A portal appears. The original file has not moved.

Double-click any portal to open the file in its default app.
4

Rename and organise

Rename a portal

Right-click a tile and select Rename. Type a display name that makes sense to you. The file on disk is completely untouched — only your label changes.

Useful when file names follow a company naming convention you cannot change. In Deckspace you see the name you chose. The system sees the original.

Birds of a Feather

Click the stack icon (≡) in the deck header. All portals group by file type — PDFs together, spreadsheets together, drawings together. Click it again to return to your custom order.

Drag to reorder

Hold Alt (Windows) or ⌥ Option (macOS) and drag a tile to a new position within the deck.

5

Locate, copy, share

Right-click any portal tile to get these options:

  • Locate — the File Explorer scrolls to and highlights the file in the tree.
  • Copy file path — copies the full path to your clipboard. Format follows your setting in Settings.
  • Copy parent folder path — copies the path of the folder containing the file.
  • Open in Windows Explorer (Windows) / Open in Finder (macOS) — opens the system file manager with the file highlighted in its actual location.
  • Open with (Windows only) — opens the file with a different application using the system "Open With" dialog.
6

The info panel

Click a tile once to select it. The info panel slides open on the right side of the deck.

  • Notes — free text attached to the file. Good for revision status, who sent it, what still needs checking.
  • Comments — timestamped entries that build into a thread over time. Good for logging decisions or handover notes.
  • Activity log — automatic record of every time you opened the file through Deckspace. No manual input needed.
Everything in the info panel stays attached to the portal and persists across restarts.
7

Settings

Open Settings from the bottom of the sidebar.

  • Tile size — S / M / L. Compact to see more files, or spacious for easier reading.
  • Layout — List or Grid. List is more detailed, Grid is more visual.
  • Explorer text size — S / M / L. Adjust the file tree to your screen.
  • Show file extensions — toggle on to see .pdf, .docx, .xlsx on every tile.
  • Confirm before removing — when on, Deckspace asks before removing a portal.
  • Copy path separator — choose Windows (\) or Unix (/) format. Defaults to \ on Windows and / on macOS.
  • Show hidden files — toggle on to see hidden files in the File Explorer.
  • Start location — Home or Last visited.
  • Check for updates — manually check whether a newer version is available.

More things you can do

Navigate the File Explorer by typing a path

Click the address bar at the top of the File Explorer panel. Type or paste any path and press Enter. The explorer jumps directly to that location.

Useful when a colleague sends you a file path in an email or Teams message — paste it straight in.

On Windows, use paths like C:\Users\.... On macOS, use paths like /Users/.... Both formats are supported.

Attach a file to an email

Find the file in the File Explorer panel. Drag it directly into your email client (Outlook, Gmail in browser, Teams message). The actual file is attached, not a shortcut.

This also works from a portal tile — drag the tile out of Deckspace and drop it wherever your operating system accepts a file drop (Windows Explorer, Finder, email clients, browser windows).

Move a Deck to a different Project

Drag the deck name in the sidebar and drop it onto a different project.

Reorder Projects and Decks

Drag and drop directly in the sidebar. Projects and decks can be reordered independently.

What happens if a file moves

If a file is moved or renamed outside of Deckspace, the portal detects this on next launch and attempts to find it automatically by searching nearby folders.

  • If found — the portal updates itself silently.
  • If not found — the tile shows a broken state. Right-click and select Relink to point it to the new location. Your display name, notes, and comments are preserved.

Activate your license

Settings, License, paste your license key, Activate. Your license key was emailed to you after purchase. Check your spam folder if you cannot find it.

Transfer to a new machine

  1. On your current machine: Settings, License, Deactivate this machine.
  2. Install Deckspace on your new machine.
  3. Enter your license key in Settings, License, Activate.

If you no longer have access to your old machine, email hello@deckspace.com.au and we will release the license for you.

Frequently asked questions

Does Deckspace move or copy my files?
No. Files stay exactly where they are. Deckspace only stores the path to each file. Nothing is moved, copied, or uploaded anywhere.
What happens to my files if I uninstall Deckspace?
Nothing. Your files are untouched. Your workspace data (projects, decks, portal names, notes) is stored locally on your machine — uninstalling the app does not delete it.
Can I use Deckspace with OneDrive, SharePoint, or a network drive?
Yes. Any location your operating system can access can be added as a portal. On Windows, this includes OneDrive, SharePoint mapped drives, and network drives. On macOS, this includes OneDrive, iCloud Drive, and any mounted network volume.
Does Deckspace require an internet connection?
Only for license validation on launch — one quick check per session. If you are offline, Deckspace falls back to the last validated state and continues working normally. All workspace data is local.
Can I use Deckspace on multiple computers?
One license covers one machine at a time. To move to a new machine, deactivate on the old one first (Settings, License, Deactivate this machine), then activate on the new one.
I reinstalled my operating system. How do I get my workspace back?
Windows: Your workspace data lives in %AppData%\Roaming\com.deckspace.app\deckspace.json. If you backed this up before reinstalling, copy it back to the same location after reinstalling Deckspace.

macOS: Your workspace data lives in ~/Library/Application Support/com.deckspace.app/deckspace.json. If you backed this up before reinstalling, copy it back after reinstalling.

If you did not back it up, the workspace data is gone — but your original files are untouched.
My license says "activation limit reached" but I only have one computer.
This can happen after reinstalling your operating system. If you still have access to your previous installation, open Settings, License, Deactivate this machine, then activate again. If you no longer have access, email hello@deckspace.com.au with your license key and we will release it within one business day.
A portal shows as broken. What do I do?
The file was moved or renamed outside of Deckspace. Right-click the broken tile, select Relink, then navigate to the new file location. The portal updates and all notes and comments are preserved.
Can I share a deck with a colleague?
Not in v0.1.0. Team sharing is planned for a future version.
Does Deckspace send any data to the internet?
The only outbound call is a license validation to Lemon Squeezy on launch. No workspace data, file names, paths, or usage data is ever transmitted. There is no telemetry.
Is Deckspace available on Mac and Linux?
Deckspace is available on Windows and macOS. Linux is planned for a future version. One license key works on either platform — deactivate on one machine before activating on another.
Windows showed a "Windows protected your PC" warning when I installed.
This is a Microsoft SmartScreen notice that appears for newly released software. It does not mean the software is unsafe. Deckspace is signed with an Extended Validation (EV) certificate — you can verify this by clicking "More info" in the dialog. Click Run anyway to proceed. The notice disappears automatically as more users install the app.
macOS says "Deckspace can't be opened" or shows a security warning.
Deckspace for macOS is signed with an Apple Developer ID certificate and notarized by Apple. If you see a warning, right-click (or Ctrl-click) the app and select Open. macOS will then offer an Open button that bypasses the warning. This only needs to be done once — subsequent launches work normally.
How do I install Deckspace on macOS?
Download the .dmg file from deckspace.com.au. Double-click to open it, then drag the Deckspace icon into the Applications folder. You can then eject the disk image and launch Deckspace from Applications or Launchpad.
How do I get a refund?
Email hello@deckspace.com.au within 7 days of purchase if Deckspace does not work correctly on your machine and we cannot resolve the issue. See the full refund policy in the Terms of Service.
I have a question not answered here.
Email hello@deckspace.com.au. We respond within 2 business days.