Navigating Your Files

A working project quickly grows past the point where browsing the folder tree is enough. The Files place, tabs, pop-outs, split panes and the command palette all exist so you can jump to the file you need without losing your place. This guide is the practical playbook for moving around a big project.

The Files place

Click Files on the rail to open your folder tree. The row above the tree has:

• Group by Folder and Group by File Type. Folders show your tree as you built it. File types list every file under its type, wherever it lives, which is handy for finding all your characters at once.
• New File, which lists your file types, with Manage file types at the bottom.
• New Folder, when the tree is grouped by folder.

Press ⌘B to show or hide the tree.

Working with folders

Folders in Craft are free-form. Any file type can live in any folder, and you decide how deep to go.

• Create one with New Folder above the tree, or right-click a folder and pick New Folder to nest one inside it.
• Rename or remove one by right-clicking it and picking Rename or Move to Trash.
• Reorganize by dragging any file or folder. Drop it on a folder to move it inside.

Click a folder to open it as a page of cards, one per file. Switch between grid and list, filter the folder with its search box, and add a file with its New button, which offers the folder's own file types first. On a phone, a tap opens the folder in the tree, and the button beside an open folder opens its page.

Opening files and managing tabs

Files open as tabs across the top of the Files place. Tabs stay open as you work, so you can hop between several files without losing your place.

• Click a file in the tree to open it in a tab.
• Click a tab to switch to it, and click its X to close it.
• Right-click a tab to close it, the others, the ones to its left or right, or all of them.
• Click Pop out into floating window on a tab to float the file over the workspace. Keep one file in view while you edit another.

Selecting several files

Shift-click to select a run of files and folders, or ⌘-click (Ctrl-click on Windows) to add one at a time. Right-click the selection to open, copy, move or trash them all at once.

Search and the command palette

The search box in the middle of the title bar opens the command palette. So do ⌘K and ⌘P (Ctrl+K and Ctrl+P on Windows), from anywhere in the workspace. It's the fastest way to move around once you know what you're looking for.

• Files. Start typing a name. Your open tabs come first, then matching files from the whole project. Press Enter to open one.
• Inside files. Type a word or two and pick Search inside files for to search the text of every file. If you remember an NPC's line but not their name, search for the line.
• Actions. New File, New Folder, New File Type, Edit File Types and Create Version, straight from the keyboard.
• Go to. Jump to any place: Overview, Files, Maps, Game Master, Settings, Images, Packages or Trash.
• Active File. With a file open, the palette also offers Rename, Move to Trash and Close Tab for it.

Other workspace shortcuts

• ⌘B: show or hide the file tree.
• ⌘J: show or hide Orbit's panel.
• ⌘W: close the active tab.
• ⌘\: split the editor to the right.

On Windows, use Ctrl in place of ⌘ for all of these.

Split-pane view

Sometimes one file isn't enough. Click Split editor right at the top right of the editor, or press ⌘\, to split the Files place into two panes. Each pane has its own tabs and can show a different file. Use it to:

• Edit a character while looking at the location they're in.
• Build a file type while reviewing a file that uses it.
• Compare two NPCs, two spells or two factions.

Right-click menus

Right-clicking is the shortcut for nearly every action in the tree.

Right-click a folder

• New File: create a file directly in this folder.
• New Folder: create a folder inside it.
• Paste into Folder: paste a file you copied, from this project or another.
• Copy, Rename and Move to Trash.

Right-click a file

• View on map (locations only): open the place on its map.
• Rename and Move to Folder.
• Copy and Move to Trash.

Recovering from mistakes

A few safety nets worth knowing about.

Version history per file

• Inside any open file, click Version History at the top right.
• Browse past versions of that file, and restore one if an edit went wrong.

Project version history

• Open the chevron next to Create Version in the title bar and pick Version History.
• It lists the project versions you've saved, with options to view or restore one. See Version History and Retention for how long versions stick around.

Restoring from Trash

• Click Trash on the rail. It lists the files, folders and file types you've deleted from this project.
• Click Restore on anything you want back, or Delete forever to remove it for good.
• Everything stays in Trash until you delete it forever or click Empty trash.

Copying files between projects

Sometimes a character or location belongs in more than one project.

• In the source project, right-click the file and pick Copy.
• In the other project, right-click the folder you want it in and pick Paste into Folder.
• The file appears in the new project with all its fields intact.

It's the fastest way to share a single file without bundling it into a package or importing a whole project.