You are viewing the v1 Nacelle Docs for existing merchants.New merchants can find the V2 docs here:

# Using Preact with Nacelle

Preact (opens new window) is a Fast 3kB alternative to React with the same modern API.

# The Basics

The Preact repo (opens new window) is the source for this project.

At the moment, the project is very bare-bones and handles the following operations out of the box:

  • Fetch product & collection data & display them
  • Fetch Navigation data & display it
  • Add products to a cart & checkout

More features can easily be added to it such as a connection to CMS data (more on this later).

This project doesn't currently statically build, you would have to implement this functionality yourself if needed.

# Getting started

At the root of the project start by adding an .env file with the following vars:


# CLI Commands

# install dependencies
npm install

# serve with hot reload at localhost:8080
npm run dev

# build for production with minification
npm run build

# test the production build locally
npm run serve

# run tests with jest and enzyme
npm run test

For detailed explanation on how things work, checkout the CLI Readme (opens new window).

# Fetching data from Nacelle

If you would like to extend the functionality for this project you can use Nacelle's Storefront GraphQL API (opens new window).

This will allow you to fetch data that we indexed from your PIM or CMS