Fetching contributors…
Cannot retrieve contributors at this time
102 lines (72 sloc) 3.45 KB

@page installing Installing JavaScriptMVC @parent tutorials 0


JavaScriptMVC requires Java JRE 1.6 or greater for:

  • Compression (Google Closure)
  • Running FuncUnit tests with Selenium
  • Easy updating
  • Code Generators

But your backend server can be written in any language.
Download the latest Java JRE here.

Getting JavaScriptMVC

There are 2 ways to get JavaScriptMVC:

  • Downloading
  • [developwithgit Installing JavaScriptMVC with Git]


Download the latest JavaScriptMVC. Unzip the folder on your file system or web server.
If you are using this on a webserver, unzip in a public folder where the server hosts static content.

TIP: Unzip these files as high in your apps folder structure as possible (i.e. don't put them under a javascriptmvc folder in your public directory).

Installing JavaScriptMVC with Git.

JavaScriptMVC is comprised of 7 sub projects:

You want to fork each project and add it as a submodule to your project in a public folder (where your server keeps static content). If these words mean nothing to you, or you'd like more explanation, you might want to read [developwithgit Developing With Git].

Forking the repos looks like:

@codestart text git submodule add git@github.com:YOU/legacy-steal.git public/steal git submodule add git@github.com:YOU/canjs.git public/can git submodule add git@github.com:YOU/canui.git public/canui git submodule add git@github.com:YOU/jquerypp.git public/jquerypp git submodule add git@github.com:YOU/documentjs.git public/documentjs git submodule add git@github.com:YOU/legacy-funcunit.git public/funcunit git submodule add git@github.com:YOU/jmvc-generators.git public/jmvc @codeend

Notice that CanJS is in can folder and jQuery++ is in the jquerypp folder.

After installing the repository, run:

@codestart [WINDOWS] > steal\js steal\make.js

[Lin/Mac] > ./steal/js steal/make.js @codeend

Verifing the install

In your public (or static) folder, you should have something that looks like:

@codestart static \documentjs - DocumentJS library \funcunit - FuncUnit testing library \canjs - CanJS MVC Framework \canui - Widgets built on CanJS and jQuery++ \jquery - jQuery's missing utils and special events \steal - Compression and build system \js.bat - Windows Rhino shortcut \js - Mac/Linux Rhino shortcut @codeend

Open a command line to that folder and run:

@codestart [WINDOWS] > js

[Lin/Mac] > ./js @codeend

This starts the Rhino JS engine. Type quit() to exit.