commonplace

Commonplace

Reusable components for Firefox Marketplace frontend projects.

Adding a Component

Components are stored in the dist directory. There are currently several folders in dist that group the components:

• contrib: JS modules that aren't necessary, but can be useful for some projects.
• contrib-css: CSS components that aren't the part of the base styles, but are possibly shared between some projects.
• core: necessary JS modules that power all of our projects, the Commonplace framework.
• core-css: base CSS components that ship with every project for visual consistency.
• templates: reusable templates

Updating a Component

When you add or update a component, you presumably want projects to be able to consume that component. We use Bower to manage our components.

• Bump the version in bower.json.
• Git tag that version and push to Github.

Then your projects should be able grab the new or updated component from Bower. For Commonplace projects, you can run make update to get these components into your project and into your RequireJS development configuration.

Creating a New Commonplace Project

Clone the Commonplace base template.

Run make init. This will download dependencies from Commonplace via Bower and set up a couple of configurations.

I have questions! Where do I look for more information?

You can check out the Wiki, which has plenty of documentation about the project and the Commonplace framework.