Templates

What are Templates?

Templates are starting points for development environments that you create through CodeSandbox. When you pick a template, you create a fork of the original project. Forked templates are already set up with the configuration, file structure and installed dependencies. So you don't have to spend time doing this each time you begin working on something new. They are easily accessible from the "Create" modal (opens in a new tab).

From the modal, CodeSandbox offers several official templates for several different programming languages.

You can also create your own custom templates from your projects. So you can fully customize your development start points for your particular use case and preferences. Once a custom template has been created, you can use it to start new projects through the "Create" modal (opens in a new tab). Custom templates can also be added to workspaces so workspace members can use them. Any custom templates you can access can be found in the Templates folder (opens in a new tab) on the Dashboard or under 'Workspace Templates' within the modal.

How to make a custom template

There are a few ways to create a template, but the main way is from within the "Devbox Info" panel inside the editor. When viewing one of your Devboxes, expand the "Devbox Info" panel on the left. You will then see an edit icon in line with the "Devbox Info" header. Click the icon and then check the 'Template' box in the settings pane that opens on the right of the interface.

You can also create templates from the Dashboard. You can do this by either dragging and dropping a Devbox from any folder into "Templates" (opens in a new tab) or using the right-click menu and selecting Make Devbox a Template.

Using Templates

After you've made your first custom template, there are a few places from which you can access and use them. First, inside the "Create a Devbox" modal, you will see a list of your templates under Workspace Templates. Clicking on one of these will fork the template and open it in the editor.

You can also find all your templates under the Templates folder (opens in a new tab) on the Dashboard. Clicking on any of the templates in this folder will open it in the editor.

Editing Templates

When you first create a template it will be fully editable to allow you to quickly make any required changes. Once you're happy with the template, open up the 'Template Info' settings using the instructions above. Then, check 'Frozen' and reload the page to prevent further changes. In order to make further changes to a template, you just need to uncheck 'Frozen' and reload the page again.
Any time you try to save a change to a frozen template, it will automatically fork into a new environment.

Deleting Templates

There are a few ways in which you can "delete" a template. From the "Template Info" panel inside the editor you can uncheck 'Template'. Doing this will convert the template back to a regular Devbox and remove it from the "Create" modal (opens in a new tab).

You can then delete the Devbox from your dashboard as you would normally.

Alternatively, you can use the 'right click' template's options menu inside the Templates folder (opens in a new tab) folder to select Convert to Devbox.