README.md

# Überauth Facebook

> Facebook OAuth2 strategy for Überauth.

### Setup

Include the provider in your configuration for Überauth:

```elixir
config :ueberauth, Ueberauth,
  providers: [
    facebook: [ { Ueberauth.Strategy.Facebook, [] } ]
  ]
```

Then configure your provider:

```elixir
config :ueberauth, Ueberauth.Strategy.Facebook.OAuth,
  client_id: System.get_env("FACEBOOK_APP_ID"),
  client_secret: System.get_env("FACEBOOK_APP_SECRET")
```

For an example implementation see the [Überauth Example](https://github.com/doomspork/ueberauth_example) application.

## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:

1. Add `:ueberauth_facebook` to your list of dependencies in `mix.exs`:

    ```elixir
    def deps do
      [{:ueberauth_facebook, "~> 0.1"}]
    end
    ```