Migrating from Brace
There are two options for moving your site from Brace to Squarespace: use one of Squarespace's templates, or use the Developer Platform. If you want simplicity and aren’t wed to your existing design, Squarespace's templates are for you. If you prefer to transition your design directly to Squarespace, you can create your own template using the Squarespace Developer Platform.
For Designers (Squarespace Templates):
You can use Squarespace to design your website without writing any code. You’ll start with one of Squarespace’s beautiful website templates and then modify it to match your site’s content and aesthetic choices, such as fonts, colors and branding.
As a first step, check out the variety of templates at www.squarespace.com/templates.
Once you’ve found a template that offers a similar layout to your website, you can begin to adjust the design elements to match your site. Check out the Squarespace guide for Making Style Changes. Squarespace offers plenty of ways to customize your designs by applying style tweaks, or by writing your own CSS styles.
For your content, such as additional pages or blog posts, the best approach is to copy the text from your live website on Brace.io and paste it into an appropriate block in your Squarespace site config. From there, you can adjust text attributes, and upload images. See the Squarespace guide to Adding Content in a Page.
For Developers (Developer Platform):
If you want to move your design directly to Squarespace, and you don’t mind writing some code, you can make your own Squarespace template. Using the Squarespace Developer Platform, you can have full control of your template’s code, while your clients can edit the content using Squarespace’s web and mobile tools. This is a great way to collaborate with non-developers, but it also means that you’ll need to modify your website to work with the Squarespace CMS.
Creating a “hello world” template
If you’re the kind of developer that likes to jump in head-first, great! We’ve put together this simple template for you to use as a starting point:
When you’re ready to start hacking on the code, click the “clone this site” button. Before you can work on the template, you’ll need to enable Developer Mode for your Squarespace site. See the Initial Setup guide for more details.
We recommend using FTP to upload changes while you’re developing. FTP can be configured to automatically sync changes on save, so that you can easily preview your work.
Frequently Asked Questions
Where’s the index.html file?
In a Squarespace template, the site.region file is typically the main template file. It’s the common layout that all other files will inherit. (This can be changed using the template.conf file)
How do I develop locally?
Squarespace currently does not offer a local development configuration. A solution is in the works, but in the mean time, we suggest that you configure SFTP to automatically sync files to our server when changes are made. That way you can see your updates as you work.
What data attributes are available to my template?
To see all the data that’s available to JSON-T for a particular page, append the query parameter “?format=json-pretty” to the page’s URL. This will give you a JSON dump of the data that can be accessed.
How do I add a new page to my site?
Normally on Squarespace, you'd add and manage pages with Squarespace’s visual editing tools.
If you prefer to edit HTML using your own editing tools, you can add .page files to the pages folder with HTML content. Once you've added a page, go to the visual editor and drag the new page into the main navigation.
What template development environment do you use at Squarespace?
Create a new folder for your template. Open the empty folder in Sublime Text.
Right click the empty folder in Sublime and go to SFTP > Map to Remote…
Edit and save the generated file using your account details. Don’t forget to specify port 2030 and set the “remote_path” to “/your-site-name/”. (from “your-site-name.squarespace.com”)
Add the following line to your sftp-config.json file:
Right click the empty folder and go to SFTP > Sync Remote to Local…
Your site will now be updated automatically when you edit and save files in Sublime Text.