Commonplace

Commonplace is the place for reusable components for the Firefox Marketplace (mozilla/fireplace).

Getting Started

Install node/npm

OS X

Use boxen to install a node environment, or use homebrew:

brew install node

And make sure that /usr/local/share/npm/bin is in your $PATH, à la:

export PATH=/usr/local/share/npm/bin:$PATH

Setting up your repo

Create a new repository for your project. In it, create a basic package.json file. You can do this very easily by running npm init.

Next, install commonplace by running npm install commonplace -g. If you already have commonplace installed, update it with npm update -g commonplace.

Creating the commonplace base template

At this point, simply run commonplace install. Running this command will create a src/ directory in your project containing the minimum files needed to run your code. Other directories will also be created for L10n and other functions.

The --gitignore option is available for commonplace install. It will copy a .gitignore into your project. If one already exists, it will print a command to allow you to manually overwrite your current .gitignore file.

Updating Commonplace

To update your commonplace installation, simply run commonplace update --npm from the root of your project. Commonplace will automatically update the global commonplace library to the latest version and update all of the shared modules.

Things that haven't been built yet

• commonplace lint
• a bunch of other stuff