/base-template

A Squarespace starter template with minimal markup and styles.

Primary LanguageCSS

Base Template

A minimal template for developers getting started with Squarespace, using developer mode. No tweaks, no web fonts, no static assets, no static pages, no system collections, no collection features, no modules at all.

For more information about the Squarespace Developer Platform see developers.squarespace.com.

Usage

See the Developer Getting Started page for an step-by-step guide for getting started with the Squaresapce Developer Platform. You can create a new website using this template by visiting base-template.squarespace.com and clicking the "Create a Site Like This" button. This template is also available on GitHub.

Squarespace Templates

Each Squarespace website is based on a template like this one. Templates contain regular web files like CSS and JavaScript. In addition, Squarespace recognizes a few special file types:

JSON-T Template Files

Squarespace template files are written in JSON Template, also known as JSON-T. It is a simple yet expressive template language. JSON-T files have different extensions depending on the type of file, for example .list, .item, and .region.

LESS Files

Template LESS files (.less) are processed through the LESS preprocessor. LESS extends CSS with dynamic behavior such as variables, mixins, operations and functions.

Template Folder Structure

Squarespace template files are organized using the following folder structure at the root of your site:

  • assets: design assets — example: images, fonts and icons
  • blocks: reusable blocks of JSON-T (AKA partials) — ex: navigation.block
  • collections: collection files — [collection].list, [collection].item, [collection].conf
  • scripts: Javascript files — site.js
  • styles: stylesheet files — styles.css, styles.less
  • [root]: sitewide files — site.region, template.conf

Essential Files

At the very minimum, your template needs a .region file and a template.conf.

/site.region

Typically this file is used as the global site template – containing the site header, footer, and sidebars. This is like the index.html of your site. Every template must have at least one .region file. Simple templates will have a single .region, more advanced templates will have multiple .region files describing header, body, and footer variants. Regions files live in the root directory of a template.

See the Layouts & Regions documentation for more details.

/template.conf

Contains the configuration settings for the template. This is where you can name your template, specify layouts, add navigation sections, specify stylesheets, and other general site options. Template configuration files must live in the root directory of a template.

See the Template Configuration documentation for more details.

Further Reading

For further reading please consult the Squarespace Template Overview and other documentation on the Squarespace developers website.