KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

web-haskell-graphql-postgres-boilerplate

★ 122 Open GitHub ↗

Modern webserver in Haskell: Graphql + Postgresql + Authentication + DB migration + Dotenv and more

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Modern Haskell Webserver Boilerplate
- Graphql API
  - morpheus-graphql (https://github.com/morpheusgraphql/morpheus-graphql)
  - Schema is in `schema.graphql`
  ```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`:
  ```terminal
  $ cp .env.default .env
  ```
  ```env
  DATABASE_URL="postgres://Dandoh:dandoh@127.0.0.1:5432/webhaskell?sslmode=disable"
  JWT_SECRET="my_jwt_secret"
  ```
- Migrations
  ```terminal
  $ dbmate up
  ```
  - More uses refer https://github.com/amacneil/dbmate
- Run webserver
  ```terminal
  $ stack run
  ```
  
Now GraphQL API is at [http://localhost:8080/api](http://localhost:8080/api)

You can also access Graphql Playground at [http://localhost:8080/graphiql](http://localhost:8080/graphiql)

![Playground](https://raw.githubusercontent.com/dandoh/web-haskell-graphql-postgres-boilerplate/master/images/playground.png)

## Running on Docker
- Feed in you database & secret in `.env`:
  ```terminal
  $ cp .env.default .env
  ```
- (Optional) Edit anything you need in the .env file

- Create and start docker containers
  ```terminal
  $ docker-compose up
  ```

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

- Migrations will automatically run, and you can run them manually anytime using
  ```terminal
  $ docker-compose up dbmate
  ```
- Stack will restart whenever you change any .hs file, thanks to [entr](http://eradman.com/entrproject/)

## Contributors

PR are more than welcome. The only note is we use `ormolu` to format codes.

- [Nhan Thai](https://github.com/dandoh)
- [Pacific01](https://github.com/Pacific01)
- [Emad Shaaban](https://github.com/emadshaaban92)

web-haskell-graphql-postgres-boilerplate

Was this content helpful?

Recent Feedback

Download README