Skip to content



Repository files navigation



Mosaico backend

Ready to go backend for Mosaico editor version 0.17.4

Main features are:

  • upload templates and images for Mosaico editor
  • persist mailings into DB
  • an admin manage users/groups
  • download ZIP archives of mailings
  • sending mailings by email for testing purpose

Quick start

See the screencast


Heroku uses 2 environment config vars that will take precedence over our defaults: heroku-config-vars

about heroku's stack version

This application needs the cedar-14 stack due to some limitations while running nightmare.js more informations on nightmare-heroku



  • Node.js >=8.11.4
  • PostgreSQL >=9.6 (postgresapp on a mac)
  • Redis (brew install redis on mac redis-server to start)
  • SMTP server (like mailcatcher: brew install ruby – restart terminal – gem install mailcatcher then mailcatcher)

NB: A compiled version of sharp — which is used to resize images and declared as a dependency — should be fetched automatically by npm for your system environment. In case of troubles see sharp installation instructions.

npm install
npm run dev

Then go to: http://localhost:3000


Mosaico backend has a decent localhost-first default configuration.

We use rc for managing the configuration. See rc documentation for learning how you can override the default configuration

An easy way to start is by a making a copy of .backendrc-example to a .backendrc file and update your configuration here


No packages published


  • HTML 45.6%
  • JavaScript 42.3%
  • CSS 11.9%
  • Other 0.2%