This readme file provides a brief overview of the file and folder structure included in the default MontageJS project directory.

IMPORTANT: Be sure to replace the contents of this readme file with information relevant to your application before deploying the application or passing it on to a client.

Project Structure

The default project directory includes the following files and folders:

• assets/ — Contains global style sheets and images for the application.

• core/ — Reserved for the core modules of the application logic.

• index.html — Is the entry-point document for the application.

• node_modules/ — Contains the code dependencies required in development.

  Includes Montage, the core framework, and Digit, a mobile-optimized user interface widget set by default. Since MontageJS uses the CommonJS module system, you can leverage the npm ecosystem for additional modules. To add dependencies (e.g., foo), use npm install foo in the project directory.

  NOTE: All packages in this directory must be included as dependencies in package.json.

• package.json — Describes the application and the dependencies included in the node_modules directory.

• README.md — The default readme file.

• run-tests.html — Is a page to run Jasmine tests manually in the browser.

• test/ — Contains tests for the application.

  By default, this directory includes all.js, a module that points the test runner to all jasmine specs. To use this module run npm install to get the dependencies required to run unit tests.

• ui/ — Contains the application user interface components.

  By default, this directory contains one component: main.reel (the Main user interface component).

In development, you can expand this project directory as necessary; for example, depending on the project you may want to add the following folders:

• locale/ — For localized content.
• scripts/ — For JS libraries that do not support the CommonJS exports object and, therefore, have to be loaded using a <script> tag.

Unit Testing

MontageJS uses some pure unit tests that are straightforward Jasmine specs.

To install the test code, run npm install in your project folder. This installs the the montage-testing package, which adds some useful utilities for writing jasmine tests. You will need the file run-tests.html.

For an example of how we implement unit testing, see the digit repository:

• run-tests loads our test environment.
• data-module="test/all" inside the final script tag tells the system to load test/all.js.
• all.js specifies a list of module ids for the runner to execute.

Note that in this example, all the tests load a page in an iframe using TestPageLoader.queueTest(). These are akin to integration tests since they test the component in a real environment.

We also test some components by mocking their dependencies.

Documentation

Here are some links you may find helpful:

• API Reference
• Documentation
• FAQ

Contact

• Got questions? Join us on irc.freenode.net#montage.
• Got feedback or want to report a bug? Let us know by creating a new Github issue.
• Want to contribute? Pull-requests are more than welcome.

Last edited: May 9, 2014