docker-ocsigen-start: A repository from balat

Ocsigen Start

Start your mobile application entirely in OCaml with eliom.

Ocsigen Start is in development

What is Eliom?

Eliom is a framework for programming web sites and client/server web
applications.
It uses very new concepts making programming very different from all
other web programming tools, and allowing to write a complex web site
in very few lines of code. Both server and client parts of the program are
written in OCaml, as a single program.

Source: Ocisgen website

What is Ocsigen Start?

Ocsigen Start is a set of higher-level libraries for building client-server
web applications with Ocsigen (Js_of_ocaml and Eliom).

Source: [Ocsigen Start github reposity](https://github.com/ocsigen/Ocsigen Start)

What does this container contain?

This container uses ocaml/opam:debian image. It also installs PostgreSQL (needed by Ocsigen Start).

What does this container not contain?

This container has no Android SDK installed, given you the choice to use a volume if you have Android SDK installed on your machine. For the same reason, NodeJS, NPM and Cordova are not installed.

Useful volumes

A workspace for your eliom mobile project is created in the OPAM home. It is useful to share this repository to be able to use your development environment (such as your editor). Use
```
docker run -it \
  -v /home/opam/workspace \
  dannywillems/docker-ocsigen-start
```
Such as said previously, Cordova, NodeJS and Android SDK are not installed to let you the choice to use your existing installation. Don't forget to add NPM packages repository to the container path as well as android_home variable.

Start a new eliom mobile application

Create a new container:
```
docker run -it dannywillems/docker-ocsigen-start bash
```
Update and upgrade (if needed) OPAM packages
```
eval `opam config env`
opam update && opam upgrade
```
To create a new mobile eliom application in the workspace directory, use
```
cd ~/workspace
eliom-distillery -y -name eliom_is_awesome -template os.pgocaml
```
The created project comes with an example. You can build it for Android with:
```
make android
```
To install and run the application on your Android smartphone, you can use
```
make run-android
```

What about Cordova plugins?

A binding in OCaml using gen_js_api to Cordova plugins is done here.

balat/docker-ocsigen-start