Home

Welcome to LIBERATED quick start! With the few steps defined below, you can be up and running with a working application based on LIBERATED. You can then use that as the beginnings of your custom application.

You do not need to clone this project. It is probably better to instead retrieve the tarball and create your own local repository (that you may then push back to your own github account), as described below.

NOTE: This process assumes you are running on Linux. Some of these steps likely do not work in other environments.

• Change to your development directory, denoted here by $(DEV_DIR):

  cd $(DEV_DIR)

• Download the liberated-quick-start-xxxxxxx.tgz file:

  https://github.com/liberated/liberated-quick-start/tarball/master

• Extract it:

  tar -xvzf liberated-liberated-quick-start-xxxxxxx.tar.gz

• Create the git repository and submodules

  cd liberated-liberated-quick-start-xxxxxxx

  git init

  mkdir lib

  git submodule add git://github.com/qooxdoo/qooxdoo.git lib/qooxdoo

  git submodule add git://github.com/liberated/liberated.git lib/liberated

Build the source version which uses a simulated database in the browser

• Change directory into the frontend example directory:

  cd frontend/example

• Build the source version:

  ./generate.py source

• Load the source version in the browser. It uses the in-browser simulated database. The url is:

  file:///$(DEV_DIR)/liberated-quick-start/frontend/example/source/index.html

Build a version that runs on App Engine or a local App Engine emulator

• Change directory into the App Engine backend directory:

  cd ../../backend-appengine

• Build the App Engine backend:

  ./generate.py build

• Run the App Engine emulator with this application. The server is ready when it displays the port number (8080). For some reason, it can take 15-30 seconds, sometimes, before it is ready:

  ./run.sh war

• Load this build in the browser. It uses the App Engine Emulator's datastore. The url is:

  http://localhost:8080/

Build a version that runs in Jetty and talks to a SQLite database

• Change directory into the Jetty / SQLite backend directory:

  cd ../backend-jettysqlite

• Build the Jetty / SQLite backend:

  ./generate.py build

• Run the Jetty server with this application. It will display a "js>" prompt and then load the server application. It is ready to connect to when it shows the port number (3000) at the very end of an INFO line. This server will create an SQLite3 database in /tmp/example.db:

  ./server.sh build

• Load this build in the browser. It uses an SQLite database which it creates as /tmp/example.db. The url is:

  http://localhost:3000/