Managing Files

There are two ways to edit files in Espresso: as individual files that open in their own tab and within projects.


Individual files

To open a file in Espresso, use File ⟩ Open... (command O) menu item or drag and drop the file on Espresso's Dock icon. You can then drag and drop the file's tab to reorder tabs in its window, move it into its own window, move it into the tab bar of another window, or move it into the Workspace for an open project.

You can choose whether files open by default in a new window or a new tab in the general preferences.


An Espresso project is a folder in the Finder where you store your website files, along with some metadata that Espresso maintains to keep track of server settings, what files are open, and so forth. Using projects allows you to automatically reopen the last files you were editing, sync files with a remote server, and use find and replace across multiple files.

To view all your projects, choose Window ⟩ Projects (shift command 1). Within the Projects window you can:

Custom icons for projects must be black icons with transparent backgrounds. PNG files work best. Other images may result in odd behavior.

At any time, you can also create a new project using the File ⟩ New Project... (shift command N) menu item.

Temporary projects

If you want to work with a particular folder but do not want to create a project, you can drag and drop the folder on the Espresso Dock icon to open a temporary project. Temporary projects behave identically to normal projects, except that none of their settings are saved between launches (so if you create any FTP settings you will lose them, the window will not remember which files you had open in your Workspace, and so forth).

Project settings

While working within a project, you can change its settings by clicking the actionbutton.