Skip to main content

Editing a Folder on Your Computer

warning

Currently, only Google Chrome supports editing directly on the filesystem. This may change in the future as more browsers add support for the File System Access API. If your browser does not support this, you can Import/Export your project instead.

You can edit a project directly on your computer's local filesystem in the Easel Game Editor, if your browser supports it. Once your project gets large, this is the safest way to work on your project, as it means every edit you make is saved immediately to disk. This also allows you to use your own text editor to edit the files in your project, and to use source control software like Git to keep historical versions of your project.

Creating a new project​

How to create a new project on your filesystem:

  1. Launch the Editor from the top right corner of this screen, then create a new project using the New Project button.
  2. Click the Save button in the toolbar. Choose a location on your computer to save the project. Create a new, empty folder to save your project in, then click Save.

Now every change you make will be saved immediately to the folder on your filesystem.

Editing an existing project​

How to open an existing project on your filesystem:

  1. Launch the Editor from the top right corner of this screen, then open an existing project using the Open Project button.
  2. Choose the folder where your project is saved on your computer, then click Open.

Using an external editor​

When you are editing a project on your filesystem, you can use your own text editor to edit the files in your project. Any changes you make outside of Easel will be picked up by the Editor when you switch back to it.

The popular text editor at the moment is Visual Studio Code.

The .easel folder​

If you are saving a project to your filesystem, you may notice that the Easel Editor creates a .easel folder in your project folder on your filesystem. This contains various Editor configuration settings for your project. We recommend you leave this folder alone.

tip

If you are using Git or another source control system, you should add the .easel folder to your .gitignore file (or equivalent) as it contains data that is specific to your local machine that does not need to be shared with others.