No description
Find a file
Evan Czaplicki b0a856eb5f Merge pull request #421 from maxsnew/test
Test Re-org and Start Property Testing
2013-12-30 00:27:50 -08:00
compiler Merge pull request #421 from maxsnew/test 2013-12-30 00:27:50 -08:00
libraries Mess with documentation for empty 2013-12-24 10:16:17 -08:00
runtime Merge branch 'master' into dev 2013-11-19 22:34:08 -08:00
server Stop using a custom cache directory, and stop deleting the cache immediately. Also clean up related code. 2013-10-30 16:31:29 +01:00
tests Style tweaks and use cross-platform file name construction. 2013-12-30 02:19:02 -06:00
.gitignore Setup QuickCheck and add Literal Parse/Print test 2013-12-29 16:50:41 -06:00
changelog.txt Add notes about sorting and laziness 2013-12-09 14:14:04 -08:00
CONTRIBUTING.md Use the github sanctioned name for this file, based on new facts from @devth 2013-12-24 10:27:45 -08:00
ContributorAgreement.pdf Mess around with wording and switch to using a pdf for the contributor agreement 2013-12-13 17:54:27 -08:00
Elm.cabal Setup QuickCheck and add Literal Parse/Print test 2013-12-29 16:50:41 -06:00
How to Request Features.md Add note about how to request features to the main repo 2013-12-21 14:48:53 -08:00
LICENSE It's 2013 everyone! 2013-09-13 12:09:10 -07:00
README.md Update README.md 2013-11-07 18:59:50 +01:00
Setup.hs Fix cabal configure in Cabal version 1.18. 2013-09-21 16:52:01 -05:00

Learn about the Elm programming language at elm-lang.org.

Install

Note for OS X 10.9 Maverics: you must follow these directions before continuing!

Download the Haskell Platform 2012.2.0.0 or later. Once the Haskell Platform is installed:

cabal update
cabal install elm
cabal install elm-server

Use

To use elm and elm-server you may need to add a new directory to your PATH.

Cabal should tell you where your executables are located upon successful installation.

For me, the executables were placed in /home/evan/.cabal/bin which I appended to the end of my PATH variable in my .bashrc file.

See this tutorial if you are new to changing your PATH in Unix/Linux.

My First Project

Now we will create a simple Elm project. The following commands will set-up a very basic project and start the Elm server.

mkdir helloElm
cd helloElm
printf "import Mouse\n\nmain = lift asText Mouse.position" > Main.elm
elm-server

The first two commands create a new directory and navigate into it. The printf commands place a simple program into Main.elm. Do this manually if you do not have printf. The final command starts the Elm server at localhost:8000, allowing you to navigate to Main.elm and see your first program in action.

Final Notes

The elm package provides support for compilation of Elm code directly in Haskell. Check it out on Hackage if you are interested.

If you are stuck, email the list or ask a question in the #Elm IRC channel.