Getting Started

You'll need Node.js installed first (comes with NPM included).

Use this command to check the version:

node -v

Create a project

The fastest way to get started is with the official Starter:

npx degit maizzle/maizzle my-project

That will clone the Starter repository into my-project.

Next, switch the current directory to my-project and install dependencies:

cd my-project

npm install

Development

Maizzle includes different commands for developing locally on your machine and for building production-ready emails.

Local

You can start a development server that watches for file changes and automatically refreshes a preview in the browser.

Start local email development by running the dev npm script:

npm run dev

This will start the local server at http://localhost:3000

Try making a change to a template in your editor and save it: the browser tab will refresh to show the updated HTML.

Production

Build production-ready emails that have inlined CSS and many other optimizations, by running the following command:

npm run build

This will use settings in your project's config.production.js to compile email templates that you can use with your ESP or in your application.

Updating

Maizzle is listed as a dependency in your project's package.json file:

"dependencies": {
  "@maizzle/framework": "latest"
}

By default, the latest version will be installed. To use a specific version, first change the value to the desired release number:

"dependencies": {
  "@maizzle/framework": "4.0.0"
}

Then, re-install dependencies by running npm install in your project's root folder.

Clean update

If for some reason you're not getting the correct version or are running into installation issues, delete your node_modules folder and your package-lock.json file from the root of your project and then run npm install again.

This will do a fresh install of all dependencies.