Protocol

A modular design system for Mozilla websites.

https://protocol.mozilla.org/

Protocol is in an early stage of development and likely to change a lot in the near future. If you're interested in using it on your project, let us know and we can help you.

Getting Started

Protocol is built on the Node.js platform and published to NPM, so be sure to have both installed before proceeding.

Installation

To use Protocol in your website you can install the core package directly from NPM:

npm install @mozilla-protocol/core --save

Alternatively, you can also download the latest release from GitHub.

Usage

Once installed, the relevant CSS and JS files will be available in your project under ./node_modules/@mozilla-protocol/core/.

The core CSS file is bundled as protocol.css, which contains styling for things such as basic elements and typography. Component and layout CSS is bundled as protocol-extra.scss for convenience.

Note: The original source (.scss) files are also included in the published package. You may want to consider compiling your own CSS to include only what you need for each page of your website, in order to further optimize for performance.

Building From Source

To build Protocol from source including the documentation site, you can clone the repo from GitHub:

$ git clone https://github.com/mozilla/protocol.git
$ cd protocol
$ npm start

Running npm start will install dependencies, build your toolkit, and start the development server at http://localhost:3000.

Further Documentation

• Project Structure
• Build Process
• Publishing
• Deployment
• Acknowledgements