Create and validate Heroku app.json manifests

npm install apps


apps is a node module for creating and validating Heroku app.json files. It works in node.js and the browser.


The app.json schema is defined using the JSON Schema specification and is validated with the awesome revalidator node module.

See the schema at schema.js.


With Node.js or Browserify

Download the module from npm:

npm install apps --save

Require it in your script:

var App = require("apps")

In Browser (without Browserify)

If browserify isn't your thing, use the pre-compiled browser-ready bundle in dist/app.js. Include this file in your html page and it will create window.App for you.


new App(payload)

Instantiate with a JSON filename:

var app = new App(__dirname + "/path/to/app.json")

Instantiate with a JSON string:

var json = "{name: \"small-sharp-tool\", description: \"This app does one little thing, and does it well.\"}"
var app = new App(json)

Instantiate with a JavaScript object:

var app = new App({
  name: "small-sharp-tool",
  description: "This app does one little thing, and does it well.",
  keywords: ["productivity", "HTML5", "scalpel"],
  urls: {
    website: "",
    success: "/getting-started"
  env: {
  addons: [


Once you've instantiated an app, you can validate it:


Validates the app manifest and returns true or false


Returns null if app manifest is valid.

Returns an array of error objects if invalid:

  {property: "name", message: "is required"},
  {property: "website", message: "is not a valid url"}


Return an object with valid and errors, per the revalidator module's validation function.


Return a pretty JSON string representation of the manifest, without any superfluous properties.


Make a web request to concoction for a list of addon prices.

App.fetch(url, callback)

You can fetch app manifests straight from GitHub. The github-raw-cors-proxy service is used to make the app.json file downloadable from browsers.

var App = require("apps")
App.fetch('zeke/harp-slideshow-template', function(err, manifest) {
  console.log(err, manifest)


Generates an example manifest from example content in the schema.



npm install
npm test
    ✓ accepts a filename
    ✓ accepts a JSON string
    ✓ accepts a JavaScript object
    ✓ returns null for .errors if app is valid
    ✓ requires name
    ✓ does not allow empty-string name
    ✓ validates website url
    ✓ validates repository url
    ✓ validates logo url
    ✓ render pretty JSON
    ✓ ignores properties that are not part of the schema
    ✓ fetches a remote list of addons and their total Price (526ms)
    ✓ downloads remote manifests with github shorthand (271ms)
    ✓ downloads remote manifests with fully-qualified github URLs (201ms)
    ✓ builds an example manifest from properties found in the schema
    ✓ is valid
    ✓ has expected properties


To prepare a browser-ready bundle in dist/apps.js, run the following:

npm run build



npm loves you