shard-kemal/docs/tutorial.md

# Kemal Tutorial

## 1. Install Crystal

```
brew update
brew install crystal-lang
```

## 2. Installing Kemal

You should create your application first:

```
crystal init app your_app
cd your_app
```

Then add *kemal* to the `shard.yml` file as a dependency.

```yml
dependencies:
  kemal:
    github: sdogruyol/kemal
    branch: master
```

You should run `shards` to get dependencies:

```
shards install
```

It will output something like that:

```
$ shards install
Updating https://github.com/sdogruyol/kemal.git
Installing kemal (master)
```

## 3. Include Kemal into your project

Open `your_app/src/your_app.cr` and require `kemal` to use Kemal.

```ruby
require 'kemal'
```

## 4. Hack your project

Do some awesome stuff with awesome Kemal.

```ruby
get "/" do
  "Hello World!"
end
```

All the code should look like this:

```ruby
require "kemal"

get "/" do
  "Hello World!"
end
```

## 5. Run your awesome web project.

```
crystal build --release src/your_app.cr
./your_app
```

You should see some logs like these:

```
[development] Kemal is ready to lead at http://0.0.0.0:3000
2015-12-01 13:47:48 +0200 | 200 | GET / - (666µs)
2015-12-05 13:47:48 +0200 | 404 | GET /favicon.ico - (14µs)
```

Now you can be happy with your new, very fast, readable web project.