About Stencil

Stencil is BigCommerce’s theme engine. It incorporates industry best practices in technology, design standards, SEO, and allows developers to build a stunning storefront that engages shoppers and encourages checkouts on any device. Stencil themes are supported on the following browsers. Stencil is responsible for powering the BigCommerce Cornerstone theme.

The Store Design tool available on Stencil themes allows merchants to customize a storefront’s look and feel with no coding, making customizations possible by a wide range of users. Store Design enables quick and easy customization of a theme’s colors, typography, banners, headings, carousel, and footer. It also enables customization of a storefront’s layout characteristics, such as the number of products displayed in various panels, category pages, and brand pages. For details, see Personalizing Your Theme.

BigCommerce Stencil themes are responsive, mobile friendly themes, allowing shoppers to have a first class experience across any device. Each Stencil theme can contain one to four variations. You can optimize individual variations for specific markets, audiences, and styles, while still managing and distributing all of these variations as one theme.

Cornerstone

BigCommerce’s Cornerstone theme is the building block and starting point for rapidly developing themes for BigCommerce. Cornerstone is available open source on Github.

Cornerstone comes in three, fully-responsive variations:

  • Cornerstone Light
  • Cornerstone Warm
  • Cornerstone Bold

See the Cornerstone Light theme demo to experience a Stencil theme’s capabilities.

As the default theme on new stores, Cornerstone is typically the first theme to support new theme-related features and improvements. See the BigCommerce Developer Changelog for the latest Cornerstone news and release notes.

Stencil CLI

The Stencil CLI enables developers to locally develop and customize on any Stencil theme with no impact on a merchant’s live storefront during the development process. When developing locally, developers have access to real-time Browsersync preview and testing across desktop, mobile, and tablet devices/viewports.

Stencil CLI runs on the Node.js runtime environment. Installing Node.js also provides the required npm package manager.

Flexible templates

Stencil’s logic based templates allow BigCommerce developers to customize storefront pages efficiently with the lightweight templating language, Handlebars.js. Handlebars.js allows you to efficiently embed dynamic and conditional logic onto your storefront pages.

Powerful CSS stack

Stencil themes support both Sass and SCSS. Developers can use these popular CSS pre-processors to nest CSS properties, variables, and mix-ins.

Cornerstone uses a BigCommerce SCSS Framework Citadel, which is built on top of Foundation v5.5.3 (Foundation v6.x not currently supported).

Foundation assets are located in the following directories:

  • assets/scss/settings/foundation/
  • assets/scss/components/foundation/

Front Matter

Stencil’s use of YAML Front Matter allows developers to request only the objects needed on the storefront, increasing page speed and allowing developers to define the content to render with just a few keystrokes.

JavaScript event hooks

Stencil themes can access remote objects through event hook and use the hooks to trigger defined events based on shopper behavior. This will allow you to collect product data and optimize a shopper’s experience. To facilitate theme-building, BigCommerce provides stencil-utils – a client-side library for managing event hooks.

Blueprint (Legacy framework)

For information on Blueprint, BigCommerce’s legacy theme framework, see Blueprint Themes.

Support

Developer Community

This is a great place to get help from other developers who work on the BigCommerce platform. If you have BigCommerce specific questions this is the best place to ask. It’s also great for beginners to get assistance.

Stack Overflow

Are you a more experienced developer or have a programming language specific question? This is a good place to ask questions and get help. The developer community is the best place to get answers about the BigCommerce platform specifically.

If you need direct assistance, you can contact BigCommerce Support through Live Chat, Phone Support, or Email Support.

Resources

Related Articles

Sample Apps

Additional Resources