README: remove old content.
parent
6829b6445b
commit
efbadd09f8
88
README.md
88
README.md
|
|
@ -1,91 +1,11 @@
|
|||
# Halogen Template
|
||||
# dnsmanager interface
|
||||
|
||||
### Quick Start
|
||||
```sh
|
||||
git clone https://github.com/purescript-halogen/purescript-halogen-template.git halogen-project
|
||||
cd halogen-project
|
||||
npm install
|
||||
npm run build
|
||||
npm run serve
|
||||
make
|
||||
```
|
||||
|
||||
### Introduction
|
||||
|
||||
This is a template for starting a fresh project with the [Halogen](https://github.com/purescript-halogen/purescript-halogen) library for writing declarative, type-safe user interfaces.
|
||||
|
||||
You can learn more about Halogen with these resources:
|
||||
|
||||
- The [Halogen documentation](https://github.com/purescript-halogen/purescript-halogen/tree/master/docs), which includes a quick start guide and a concepts reference.
|
||||
- The [Learn Halogen](https://github.com/jordanmartinez/learn-halogen) learning repository.
|
||||
- The [Real World Halogen](https://github.com/thomashoneyman/purescript-halogen-realworld) application and guide. Note that the published article is written for the older halogen v4, but the code and comments cover the current halogen v5.
|
||||
- The [API documentation](https://pursuit.purescript.org/packages/purescript-halogen) on Pursuit
|
||||
|
||||
You can chat with other Halogen users on the [PureScript Discourse](https://discourse.purescript.org), or join the [Functional Programming Slack](https://functionalprogramming.slack.com) ([invite link](https://fpchat-invite.herokuapp.com/)) in the `#purescript` and `#purescript-beginners` channels.
|
||||
|
||||
If you notice any problems with the below setup instructions, or have suggestions on how to make the new-user experience any smoother, please create an issue or pull-request.
|
||||
|
||||
Compatible with PureScript compiler 13.x
|
||||
|
||||
### Initial Setup
|
||||
|
||||
**Prerequisites:** This template assumes you already have Git and Node.js installed with `npm` somewhere on your path.
|
||||
|
||||
First, clone the repository and step into it:
|
||||
|
||||
```sh
|
||||
git clone https://github.com/purescript-halogen/purescript-halogen-template.git halogen-project
|
||||
cd halogen-project
|
||||
```
|
||||
|
||||
Then, install the PureScript compiler, the [Spago](https://github.com/purescript/spago) package manager and build tool, and the [Parcel](https://github.com/parcel-bundler/parcel) bundler. You may either install PureScript tooling _globally_, to reduce duplicated `node_modules` across projects, or _locally_, so that each project uses specific versions of the tools.
|
||||
|
||||
To install the toolchain globally:
|
||||
```sh
|
||||
npm install -g purescript spago parcel
|
||||
```
|
||||
|
||||
To install the toolchain locally (reads `devDependencies` from `package.json`):
|
||||
```sh
|
||||
npm install
|
||||
```
|
||||
|
||||
### Building
|
||||
|
||||
You can now build the PureScript source code with:
|
||||
|
||||
```sh
|
||||
# An alias for `spago build`
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Launching the App
|
||||
|
||||
You can launch your app in the browser with:
|
||||
|
||||
```sh
|
||||
# An alias for `parcel dev/index.html --out-dir dev-dist --open`
|
||||
npm run serve
|
||||
```
|
||||
|
||||
### Development Cycle
|
||||
|
||||
If you're using an [editor](https://github.com/purescript/documentation/blob/master/ecosystem/Editor-and-tool-support.md#editors) that supports [`purs ide`](https://github.com/purescript/purescript/tree/master/psc-ide) or are running [`pscid`](https://github.com/kRITZCREEK/pscid), you simply need to keep the previous `npm run serve` command running in a terminal. Any save to a file will trigger an incremental recompilation, rebundle, and web page refresh, so you can immediately see your changes.
|
||||
|
||||
If your workflow does not support automatic recompilation, then you will need to manually re-run `npm run build`. Even with automatic recompilation, a manual rebuild is occasionally required, such as when you add, remove, or modify module names, or notice any other unexpected behavior.
|
||||
|
||||
### Production
|
||||
|
||||
When you are ready to create a minified bundle for deployment, run the following command:
|
||||
```sh
|
||||
npm run build-prod
|
||||
```
|
||||
|
||||
Parcel output appears in the `./dist/` directory.
|
||||
|
||||
You can test the production output locally with a tool like [`http-server`](https://github.com/http-party/http-server#installation). It seems that `parcel` should also be able to accomplish this, but it unfortunately will only serve development builds locally.
|
||||
```sh
|
||||
npm install -g http-server
|
||||
http-server dist -o
|
||||
```
|
||||
|
||||
If everything looks good, you can then upload the contents of `dist` to your preferred static hosting service.
|
||||
This code is an alpha version of the official interface for `dnsmanager` (second edition).
|
||||
For now, nothing much to see.
|
||||
|
|
|
|||
Loading…
Reference in New Issue