Modern Haskell Webserver Boilerplate

• Graphql API
  • morpheus-graphql (https://github.com/morpheusgraphql/morpheus-graphql)
  • Schema is in schema.graphql

    type User {
        id: Int!
        email: String!
        name: String!
        updatedAt: String!
        createdAt: String!
    }
  
    type Session {
        token: String!
        user: User!
    }
  
    type Query {
        login(email: String!, password: String!): Session!
        myUserInfo: User!
    }
  
    type Mutation {
        register(email: String!, password: String!, name: String!): Session!
        changePassword(oldPassword: String!, newPassword: String!): Boolean!
    }

• Database:
  • Postgresql + Opaleye
  • Migration using dbmate (https://github.com/amacneil/dbmate)
  • Pooling using Data.Pool

This boilerplate wires up:

• Reading .env using envy
• Database
• Graphql API
• Authorization using JWT
• Monad transformers

Running

• Feed in you database & secret in .env:

  $ cp .env.default .env
  

  DATABASE_URL="postgres://Dandoh:[email protected]:5432/webhaskell?sslmode=disable"
  JWT_SECRET="my_jwt_secret"

• Migrations

  $ dbmate up
  

  • More uses refer https://github.com/amacneil/dbmate
• Run webserver

  $ stack run
  

Running on Docker

• Feed in you database & secret in .env:

  $ cp .env.default .env
  

• (Optional) Edit anything you need in the .env file
• Create and start docker containers

  $ docker-compose up -d
  

• Enter inside the docker workspace container

  $ docker exec -it web-haskell-graphql-postgres-boilerplate_workspace_1 /bin/bash
  

• Migrations

  $ dbmate up
  

• Run webserver

  $ stack run
  

• Now you can visit: http://localhost:8080/ in your local machine.