FP Haskell Center
The easiest way to get started with Yesod is by using FP Haskell Center. FP Haskell Center provides a web based development environment with all of the Haskell toolchain and Yesod libraries preinstalled. You can get started right away by cloning an existing Yesod project.
The rest of this page provides instructions for installing on your local system.
You'll need two main tools: the Glasgow Haskell Compiler (GHC) and cabal-install, the package installer. The best way to get them is with the Haskell Platform.
If you're on Windows or Mac, download the installers from the Haskell Platform site. For Linux users, most distributions already include the platform in the repositories. On most Debian-based systems, for example, you can just run
sudo apt-get install haskell-platform
Make sure to add
$HOME/.cabal/bin to your
PATH. Once you're set up, run
to download a list of available packages. For more information on Haskell
tools, see the
tools chapter of the Mezzo Haskell book.
Mac users may also want to see
for help with their
Building Yesod and all of its dependencies is a simple procedure. Just run:
cabal update cabal install yesod-platform yesod-bin --max-backjumps=-1 --reorder-goals
Note that this will be installing a large number of packages, and may take a while. (15 minutes on modern systems, up to 40 minutes on older systems.) This is a one time setup, and will have no impact on normal development or runtime performance.
Start a new site
Now I'm sure you want to test this out! The
yesod executable has two important commands.
will ask you a few questions, and then generate a scaffolded site for you. At this point, you can follow the onscreen instructions to build and run your site. At the time of writing this page, the instructions are:
cabal sandbox init cabal install --enable-tests . yesod-platform yesod-bin --max-backjumps=-1 --reorder-goals yesod devel
which will set up a sandboxed environment, install all dependencies, and start the development server. After this is completed, you can access your site at http://localhost:3000/.
(Note: If the command line tool gives you different instructions, you should follow those instead.)
Now it's time to start coding! You can play around with the code right now, or if you want to learn more, check out these resources: