# Absinthe.Phoenix

[![Hex pm](]([![License](](
[![Build Status](](

This package integrates Absinthe subscriptions with Phoenix, so that you can use subscriptions via websockets.

For getting started guides on subscriptions see:

For getting started guides on server side rendering see:

## Installation

Install from [](

For Phoenix 1.4, see the v1.5 branch:

### Phoenix 1.5

def deps do
  [{:absinthe_phoenix, "~> 2.0.0"}]

You need to have a working phoenix pubsub configured. Here is what the default looks like if you create a new phoenix project:

config :my_app, MyAppWeb.Endpoint,
  # ... other config
  pubsub_server: MyApp.PubSub

In your application supervisor add a line AFTER your existing endpoint supervision

  # other children ...
  MyAppWeb.Endpoint, # this line should already exist
  {Absinthe.Subscription, [MyAppWeb.Endpoint]}, # add this line
  # other children ...

Where `MyAppWeb.Endpoint` is the name of your application's phoenix endpoint.

In your `MyAppWeb.Endpoint` module add:
use Absinthe.Phoenix.Endpoint

In your socket add:

use Absinthe.Phoenix.Socket,
  schema: MyAppWeb.Schema

Where `MyAppWeb.Schema` is the name of your Absinthe schema module.

That is all that's required for setup on the server.

For client side guidance see the guides.

## GraphiQL Usage

From within GraphiQL:
To use Absinthe.Phoenix from within GraphiQL, you need to tell GraphiQL about your websocket endpoint.

forward "/graphiql", Absinthe.Plug.GraphiQL,
  schema: MyAppWeb.Schema,
  socket: MyAppWeb.UserSocket

## License

See [](./