Skip to content
Exemplary real world application built with Haskell + Yesod
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
app Fixes #3: check for JWT_SECRET environment variable Feb 12, 2019
.gitignore update .gitignore May 3, 2018
logo.png Add logo and name Feb 19, 2018 updated readme Aug 20, 2018

RealWorld Example App

Built with Spacemacs Build Status

Haskell/Yesod codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

How it works

Check out this post for an overview of project's dependencies and its structure.

Getting started

Haskell Setup

  1. If you haven't already, install Stack
    • On POSIX systems, this is usually curl -sSL | sh
  2. Install the yesod command line tool: stack install yesod-bin --install-ghc
  3. Build libraries: stack build

If you have trouble, refer to the Yesod Quickstart guide for additional detail.


Start a development server with:

export JWT_SECRET="some secret value"
stack exec -- yesod devel

As your code changes, your site will be automatically be recompiled and redeployed to localhost.


stack test --flag app:library-only --flag app:dev

(Because yesod devel passes the library-only and dev flags, matching those flags means you don't need to recompile between tests and development, and it disables optimization to speed up your test compile times).


  • Read the Yesod Book online for free
  • Check Stackage for documentation on the packages in your LTS Haskell version, or search it using Hoogle. Tip: Your LTS version is in your stack.yaml file.
  • For local documentation, use:
    • stack haddock --open to generate Haddock documentation for your dependencies, and open that documentation in a browser
    • stack hoogle <function, module or type signature> to generate a Hoogle database and search for your query
  • The Yesod cookbook has sample code for various needs

Getting Help

You can’t perform that action at this time.