Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

125 lines (91 sloc) 3.959 kB

@page installing Installing JavaScriptMVC @parent tutorials 0


JavaScriptMVC requires [ Java JRE 1.6] or greater for:

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:

We (and the [ community]) would much prefer you to develop with git. JavaScriptMVC is built around modular development so it fits in perfectly with git development. Plus we can trade improvements really easy.


[ 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.

PRO 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 six 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 public/steal git submodule add public/canjs git submodule add public/canui git submodule add public/jquerypp git submodule add public/documentjs git submodule add public/funcunit @codeend

Notice that the JavaScriptMVC repository is put in a canjs 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.

Updating JavaScriptMVC

We are constantly improving JMVC. If you're using git, you can just pull changes. Otherwise, to get the latest, most error free code, in a console, type:

@codestart text C:\workspace\Cookbook>js documentjs\update C:\workspace\Cookbook>js funcunit\update C:\workspace\Cookbook>js jquery\update C:\workspace\Cookbook>js steal\update C:\workspace\Cookbook>js canjs\update C:\workspace\Cookbook>js canui\update @codeend

P.S. If you are using linux/mac you want to use ./js and change \ to /.
Jump to Line
Something went wrong with that request. Please try again.