Getting Started with Candy

Jellybeans
Jellybeans

Candy can be used to as scaffolding to help you get started with a new project. The following steps will get a local version of Eleventy + Candy installed and running. At that point it's up to you and your imagination!

Install NodeJs and NPM

Download and run the installation from nodejs.org.

Install graphicsmagick

Candy uses graphicsmagick to resize and optimize images via its gulp build process.

To install graphicsmagick locally for development, I would recommend using a package manager.

  • For Mac users brew install graphicsmagick would do the trick!
  • Windows users should use Chocolatey to manage dependencies ... once installed, open a shell window and issue a simple choco install graphicsmagick command. Done.

Clone the Candy Repo from Github

Assuming you have git installed locally, open a shell window and run:

git clone https://github.com/stickhandle/candy-11ty.git

Once downloaded, cd into the candy-11ty folder.

Install Eleventy and Candy

From the candy-11ty folder, install all dependencies:

yarn install

Build & run your local Candy website

Pick your yarn command, open your browser and you're off to the races!

Yarn Command Description
yarn start Build the Eleventy website and serve with a local web server at http://127.0.0.1:8080
yarn watch Build the Eleventy website and serve with a local web server with hot reloading at http://127.0.0.1:8080
yarn build Build the Eleventy website
yarn serve Serve the website with a local web server at http://127.0.0.1:8080

Start Customizing

Even if you are Gabe or Zack, you can do it! Learn all about Eleventy by reading the official docs.

Related Posts ...