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:
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