README.md

# ex_cors

[![Build Status](https://travis-ci.org/KamilLelonek/ex_cors.svg?branch=master)](https://travis-ci.org/KamilLelonek/ex_cors)

An Elixir Plug-based CORS middleware for Phoenix Framework.

## Installation

The package can be installed by adding `ex_cors` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:ex_cors, "~> 0.2.0"},
    # ...
  ]
end
```

After you're done, run `mix deps.get` in your terminal to fetch and compile all dependencies.

## Usage

`ex_cors` is intended to work with `Phoenix.Enpoint`. The only thing you have to do in order to make it working is to modify `your_app/lib/your_app/web/endpoint.ex` as follows:

```elixir
defmodule YourApp.Endpoint do
  use Phoenix.Enpoint, otp_app: :your_app

  # ...
  plug ExCors.AllowCorsRequests
  plug YourApp.Router
  # ...
end
```