This repository has been archived by the owner. It is now read-only.
A boilerplate for embeddable graphics.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

News Apps Graphic Kit

The News Apps Graphic Kit is a boilerplate for embeddable graphics. It was built for the Texas Tribune's News Apps team, but could easily be altered to cater to other organization's/individual's needs.



Run this command in your project's folder:

curl -fsSL | tar -xz --strip-components=1

Next, npm install.

If this is your first time to ever use the kit, you need to authorize your computer: npm run spreadsheet/authorize

Add your Google sheet's ID to the config.json, and override any sheets that need to be processed differently. (keyvalue or objectlist)

Get to work!

Connect to S3

To use the commands to deploy your project to Amazon S3, you'll need to add a [profile newsapps] to ~/.aws/config. It should look something like this:

[profile newsapps]

Then you can run these commands to build and deploy:

npm run deploy

The package will deploy to To change the location, update the package.json file.


The graphics kit comes with an empty app/assets folder for you to store images, fonts and data files. The kit works best if you add these files to app/assets/images, app/assets/fonts and app/assets/data. These files will automatically be ignored by git hub, if added to the proper folders, to prevent a storage overload and to keep files locally that may have sensitive information in an open source project.

Yeoman is being considered.

Available Commands

npm run spreadsheet/authorize

Allows your computer to interact with the scraper. Only needs to be done once! Any future uses of the graphic kit can skip this.

npm run spreadsheet/fetch

Pulls down the project's spreadsheet and processes it into the data.json file.

npm run spreadsheet/edit

Opens the project's spreadsheet in your browser.

npm run deploy

Deploys the project.

npm run assets/push

Pushes the raw assets to the S3 bucket.

npm run assets/pull

Pulls the raw assets down to the local environment.