Skip to content
Exemplary real world application built with Haskell + Yesod
Branch: master
Clone or download
Permalink
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
.travis.yml
LICENSE.md
logo.png Add logo and name Feb 19, 2018
readme.md updated readme Aug 20, 2018

readme.md

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 https://get.haskellstack.org/ | 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.

Development

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.

Tests

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).

Documentation

  • 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.