Home

Awesome

Sketch CSV Mail Merge

A lightweight Sketch plugin for importing data from .csv files using "{}" text sections. Also supports image imports

THE CSV MAIL MERGE PLUGIN IN USE

Installing

  1. Download and unzip the .zip file
  2. Double click the .sketchplugin file

Using

(NOTE: I highly recommend you save a backup of your sketch file before you run the plugin. This hasn't been tested extensively and I have no idea if it'll destroy your precious project. Works like a charm for me though ;P)

  1. Download a .csv file with your data. Make sure it includes a header row with field names. If you'd like to use a custom name for the generated artboards, include a column with name "artboard".
  2. Create a sketch file
  1. In Sketch, click Plugins -> CSV Mail Merge
  2. Click your .csv file
  3. Voila! Done

Images

You can also import images with almost no changes. Just make sure the data in your .csv for your image fields contains a full path to the image on your hard drive, i.e. /Users/you/projects/an-image.png.

Right now only .png and .jpg images are supported.

Developing

Setup

$ yarn install

Run

$ yarn watch

Debugging

$ skpm -f log

To Do

This plugin was created using skpm. For a detailed explanation on how things work, checkout the skpm Readme.