Notice: Use of the Local Development Server is now subject to our Developer Terms, rather than the Squarespace Local Development Server EULA (which we’ve sunsetted). The Oracle Binary Code License Agreement continues to cover the Java SE Runtime Environment Software that comes bundled with the Dev Server software.
Now you can work on template code locally using the Squarespace Local Development Server. The local development server is a command line tool that sets up a test server on your computer, allowing you to see changes to your template before making them "live."
NOTE: Prior to developing locally, you'll need a website set up with developer mode enabled. (See Getting Started)
To begin working locally, you first must download and install the Squarespace Local Development Server. This tool is available via Node Package Manager (NPM). Here are the steps required:
Install NPM: If you don't have NPM installed you'll need to set that up first, by following the NPM installation guide. You'll also need to ensure you have the appropriate permissions configured for NPM.
Install squarespace-server: You can do this with the following NPM command:
npm install -g @squarespace/server
First you need to have your template in Developer Mode, and have cloned your site into a folder using Git. (See Getting Started):
git clone https://site-name.squarespace.com/template.git cd template
Then, to start Dev Server, run the following command:
NOTE: When developing while using a trial site, you must use the
--auth flag as described in Advanced Usage below.
squarespace-server, you will see the following screen:
Starting Development Server _ / / _ / / / / \ / / / / / | Squarespace Inc. | / / / / / Local Development Environment \ _ / / / / / / - Version 0.1.00 Listening on port 9000
The start-up message displays both the version of
squarespace-server, and the port on which the server is running.
Now you can open your browser to your site by typing in the url
http://localhost:9000. Any changes you make to your local template files will be visible when you refresh your browser.
You can view all the options with the command:
If you have a site password, or your site is in trial mode, you'll need to log into your site via the dev server. You can do that with the following command:
squarespace-server https://site-name.squarespace.com --auth
Here's a list of some of the more useful options:
-h --help Show this screen. -d --directory=PATH Path to template source. -p --port=PORT Port that server listens on. --auth Login when starting server. --verbose Verbose logging.
You can also visit the NPM registry page for
@squarespace/server to read about additional documentation and discover more advanced options.
If you have questions about working locally, or would like to provide feedback on Dev Server, please contact support and be sure to let them know you're using the Squarespace Local Development Server.