Read Me

AppengineJS Example
===================

A simple Guestbook as an example of a JSGI Web Application powered by AppengineJS. Typically you would like to use a higher level JSGI framework like [Nitro](http://www.github.com/gmosx/nitro).


Quick start
===========

Download the [Google App Engine Java SDK](http://code.google.com/appengine/downloads.html) and make sure that the bin directory of the SDK (/path/to/appengine-java-sdk/bin) is in the path. You can start the example with:
    
    $ cd example
    $ dev_appserver.sh . 

and browse to http://localhost:8080/


Deploy to App Engine
====================

To deploy to App Engine:

    $ cd example
    $ appcfg.sh update .

Please note that the example is configured for debuging: it reloads the app per request, compilation is dissabled, debuging middleware is inserted in the request pipeline. You should use a production configuration for deployment.


Directory structure
===================

The directory structure is fully customizable. In this example, the directory structure is based on [Nitro](http://www.github.com/gmosx/nitro) conventions:

    /app.yaml - App Engine configuration file.
    /src - the web app source code.
    /root - the web app public directory, static files, etc come here.
    /packages - commonjs packages.
    /root/WEB-INF - servlet stuff, generated automatically (you can ignore this dir) 
    /root/WEB-INF/lib - java .jar files needed for your app (you can ignore this dir)


Support
=======

For questions regarding this example or appenginejs please post to the mailing list: [http://groups.google.com/group/appenginejs](http://groups.google.com/group/appenginejs)