MVC Framework for Javascript
Current State: Apple (Alpha)
There are two ways you can build PieJS: using Bakery (preferred), using Jake.
Bakery is our home built command line node module. It comes with a built-in http server
If you don't have npm yet you'll need to install it. See this guide for help: http://howtonode.org/introduction-to-npm
To install Bakery:
npm install -g bakery
This will install it globally and make it available in your bin. If you know what you're doing and don't want to install it globally that's fine.
Start a new app:
mkdir ~/taste-test
cd ~/taste-test
bakery bake apple pie
This will set up the folder you are in with an apple pie instance. If you want to develop from the master branch you can run bakery bake master pie but breaking changes happen all the time in master so there are no guarantees about it's current state.
Start a server (run from the root of your applicaiton folder):
bakery server
This will, by default, create a server for you to view your app at http://localhost:8080 (use http://localhost:8080/index.dev.html for the unminifyied javascript, recommended for development). Sometimes the minifying takes a little extra time and so you may see a blank screen the first time, but if you wait a couple seconds it should finish. Also we have a built in file watcher so every time you modify a file in your App folder it will automatically rebuild your javascript files.
Don't want the server or file watcher? You can manually run minify to create the unminified and minified versions of your code
bakery minify
Jake is a tool I started using when I first started building PieJS. It's a nice tool but I think we've out grown it. I won't really support it in the future but I'll do pull requests on it if others are interested in supporting it
If you don't have npm yet you'll need to install it. See this guide for help: http://howtonode.org/introduction-to-npm
To install Jake:
npm install -g jake
This will install it globally and make it available in your bin. If you know what you're doing and don't want to install it globally that's fine.
Start a new app:
Our jakefile doesn't have any support for downloading pie so you will have to either git clone the repo or download the zip from github.
Once you have the files you can run the following to build the javascript files for you
jake rebuild
This will create all of the javascript and html files that you will need. It doesn't have any other cool magic like bakery. I was going to remove the jakefile but I figured I already made the effort to create it it so I thought I'd leave it in to give people options.
- Create controller
file: App/Controller/Example.js
App.Controller.Example = Pie.Controller.extend({
});- Create action
file: App/Controller/Example.js
App.Controller.Example = Pie.Controller.extend({
index: function() {
}
});- Create view
file: App/View/Example/index.html
<h1>Hello, World</h1>-
In root directory run 'bakery server'
-
Navigate to app in web browser
- Reopen controller and add object
file: App/Controller/Example.js
App.Controller.Example = Pie.Controller.extend({
index: function() {
return {
name: "Chris London"
};
}
});- Reopen view and add object
file: App/View/Example/index.html
<h1>Hello, {{name}}</h1>-
In root directory run 'bakery server'. If you're already running bakery server it should automatically compile the files on save so you won't need to do this again.
-
Navigate to app in web browser