This is a fairly basic starter for Purescript React Basic with (hopefully) enough features to tinker with and demonstrate that React Basic with Purescript is a pretty OK way to make web apps.
This repository is not an example of idiomatic Purescript development as I would not consider myself experienced enough to really know what that is, however hopefully it should be enough to get an interested beginner on their feet and making/breaking things.
Purescript is a Haskell-esq pure functional language that compiles to Javascript.
React Basic is a set of bindings to React created by Lumi. It contains a number of additional features, most interestingly a reducer-esq way of handling component state ala ReasonReact. For more details see the repo or the documentation.
As well as the react-basic package it uses affjax for fetching content, simple-json for decoding json data, and test-unit for unit tests. You can bin all this other stuff if you like, it is merely there because it is what I prefer.
Download the repository:
git clone https://https://github.com/danieljharvey/another-react-basic-starterChange to the exciting new folder you have created.
cd another-react-basic-starterInstall the Javascript dependencies (you can also use npm here, your funeral, etc)
yarn installThis will build all of the Purescript in the project (and more importantly, show you any errors)
yarn purs:buildThis will run the app on a Parcel server, which you can view by navigating to localhost:1234 in your browser. It also runs pulp -w build to make sure your code changes update in the browser.
yarn startThere are also some basic unit tests you can run with
yarn testAnd once you are ready to share your creation with the world, you can make a static version with:
yarn purs:buildpurescript is a Haskell-esq language that compiles to (amongst other things) Javascript.
psc-package is a package manager for Purescript which uses sets of packages to ensure everything we use it going to work together. Conceptually it is similar to Stack used by Haskell.
https://github.com/purescript/psc-package
pulp is a Purescript build tool that does a whole host of good things (and has a nice GIF of Jarvis Cocker dancing on it's github). It is used here for running the build and the unit tests.
https://github.com/purescript-contrib/pulp
parcel is a zero-config web app bundler. It is used here to smash everything together and put it in a browser.
https://github.com/parcel-bundler/parcel
test-unit is a Purescript test runner that let's us do async tests and other good things.
https://github.com/bodil/purescript-test-unit
simple-json is a package for converting to and from JSON, without having to do very much work, which I thoroughly approve of.
https://github.com/justinwoo/purescript-simple-json
affjax is a Purescript library for making AJAX calls.
https://github.com/slamdata/purescript-affjax
pscid is a Purescript file watcher that is pretty handy for checking type errors as you work. I create quite a lot of these so this is pretty essential.
https://github.com/kRITZCREEK/pscid
This is a fork of spacchetti-react-basic-starter, which is in turn a fork of the original LumiHQ/React-Basic-Starter.
It removes the Nix and Spacchetti stuff (not because that stuff is not great, but I was concerned it may be too many new concepts at once for a beginner) and added a more fully featured sample app to demonstrate that indeed, making (semi) nice things is possible with this setup.