Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bamboo/ghcjs-starter-project
https://github.com/bamboo/ghcjs-starter-project
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/bamboo/ghcjs-starter-project
- Owner: bamboo
- License: other
- Created: 2016-08-10T21:25:09.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-08-09T02:27:21.000Z (over 8 years ago)
- Last Synced: 2024-10-28T19:57:38.363Z (3 months ago)
- Language: Haskell
- Size: 39.1 KB
- Stars: 0
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GHCJS Starter Project
See [LICENSE](./LICENSE) for terms of use.
Made by [Chris Allen](http://bitemyapp.com) ([Twitter](https://twitter.com/bitemyapp)), author of the book [Haskell Programming from first principles](http://haskellbook.com).
This is intended to be a _bare_ starter project. If I make new ones with examples/bindings to other frameworks, I'll make other git respositories and link them here.
## Getting started
### Install GHCJS
```
$ cd ./frontend && stack setup
```
This will build GHCJS from scratch and boot the basic GHCJS libraries, this _will_ take some time.
### Compile and symlink assets
```
$ make frontend
```
To auto-rebuild frontend assets, use `frontend-watch`:
```
$ make frontend-watch
```
### GHCJSi
Keep in mind `GHCJSi` hasn't had quite as much time to get a shake-out as `GHCi` so if you run into any issues, _please_ report it to [the GHCJS project](https://github.com/ghcjs/ghcjs)!
```
$ cd frontend && stack exec -- ghcjs --interactive
```
You should see a warning about:
```
socket.io not found, browser session not available
```
Install socket.io with Node.js:
```
$ sudo npm install -g socket.io
```
Then set your `NODE_PATH` so GHCJS can find your node packages. My global `node_modules` is in `/usr/local/lib`, so it looked like:
```
export NODE_PATH=/usr/local/lib/node_modules
```
Then starting GHCJS should be free of the socket.io warning:
```
$ stack exec -- ghcjs --interactive
GHCJSi, version 0.2.0-7.10.3: http://www.github.com/ghcjs/ghcjs/ :? for help
Prelude>
```
Then connect your browser to the exposed web server at `localhost:6400`, and load the `src` dir to see it in action. There'll be a slight delay the first time you `GHCJSi` to evaluate something, but then it should work fine:
```
Prelude> :l src/Lib.hs
[1 of 1] Compiling Lib ( src/Lib.hs, interpreted )
Ok, modules loaded: Lib.
*Lib> :set -XOverloadedStrings
*Lib> console_log "blah"
*Lib>
```
If you check your browser's inspector/JS console, you should see "blah" in the log.
### Build/run backend
For building the web app binary:
```
make backend
```
Lately I use `app/DevelMain.hs` and `update` to fire up and reload the web app server, but you can try `yesod devel` to auto-rerun the app:
```
cd backend && stack install yesod-bin && stack exec -- yesod devel
```