<!--wodoc:header-->

# Your first app in 5 minutes

<!--wodoc:end-->
*The code of this tutorial has been tested against Eliom 6\.0.* <br/>

This tutorial describes how to get started with Ocsigen quickly. Thanks to an application template provided by the Ocsigen team, you will get to a working application with standard functionality like users and notifications in only a few minutes. This template can be used for learning purposes, or even as a starting point for your own product.

The template you will use comes from `Ocsigen Start`. Ocsigen Start provides a complete mechanism for adding and managing users, including activation links and password reset. It additionally contains a module for displaying tips, a module for sending notifications to your users, and other utilities typically needed in modern Web applications.

The template comes with a default style (developed with SASS) that follows modern Web practices, e.g., it is responsive and thus mobile-friendly. Of course, you are free to modify the style to match your own brand or personality.

The template is multi-platform. This means that it can run on a Web browser or as a mobile app for Android, iOS, or Windows.

<!--wodoc:div class="screenshots"--> [`{files/screenshots/start1.png|Ocsigen Start`](files/screenshots/start1.png)

}

[`{files/screenshots/start2.png|Ocsigen Start`](files/screenshots/start2.png)

}

<!--wodoc:end-->
<!--wodoc:div class="screenshots"--> [`{files/screenshots/start-mobile-1.png|Ocsigen Start`](files/screenshots/start-mobile-1.png)

}

[`{files/screenshots/start-mobile-2.png|Ocsigen Start`](files/screenshots/start-mobile-2.png)

}

[`{files/screenshots/start-mobile-4.png|Ocsigen Start`](files/screenshots/start-mobile-4.png)

}

<!--wodoc:end-->

## Installation

Install the dependencies (`postgresql` and one of `sass`, `sassc`). On Debian-based systems:

```
apt install postgresql ruby-sass
```
Install Ocsigen Start and all its OCaml dependencies using OPAM:

```
opam install ocsigen-start
```
Create your application using Eliom distillery:

```
eliom-distillery -name myapp -template os.pgocaml
```
Have a look at the [README](https://github.com/ocsigen/ocsigen-start/blob/master/template.distillery/README.md) file to learn how to compile it and, possibly, to generate the mobile applications.


## I installed it and compiled it, what next?

It is now time to learn Ocsigen\! The template is a great way to get started, because it comes with multiple runnable examples that show you:

- How to do remote procedure calls (RPCs);
- How to save session data (in *Eliom references*);
- How to use the notification system;
- How to create reactive pages;
- Many examples of widgets from `Ocsigen Toolkit`:
- Carousel
- Pages with several tabs
- Time and date pickers
- ...
The corresponding files are well-commented, so you can quickly find out how things work.

<!--wodoc:div class="screenshots"--> [`{files/screenshots/start3.png|Ocsigen Start`](files/screenshots/start3.png)

}

[`{files/screenshots/start4.png|Ocsigen Start`](files/screenshots/start4.png)

}

[`{files/screenshots/start5.png|Ocsigen Start`](files/screenshots/start5.png)

}

[`{files/screenshots/start6.png|Ocsigen Start`](files/screenshots/start6.png)

}

<!--wodoc:end-->
<!--wodoc:div class="screenshots"--> [`{files/screenshots/start-mobile-3.png|Ocsigen Start`](files/screenshots/start-mobile-3.png)

}

[`{files/screenshots/start-mobile-6.png|Ocsigen Start`](files/screenshots/start-mobile-6.png)

}

[`{files/screenshots/start-mobile-7.png|Ocsigen Start`](files/screenshots/start-mobile-7.png)

}

[`{files/screenshots/start-mobile-8.png|Ocsigen Start`](files/screenshots/start-mobile-8.png)

}

<!--wodoc:end-->
Have fun\!