An open API service indexing awesome lists of open source software.

https://github.com/circuithub/halcyon

Haskell application deployment.
https://github.com/circuithub/halcyon

Last synced: 3 months ago
JSON representation

Haskell application deployment.

Awesome Lists containing this project

README

          

[Halcyon](https://halcyon.sh/)
==============================

Halcyon is a system for installing [Haskell](https://haskell.org/) apps and development tools, including [GHC](https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/) and [Cabal](https://www.haskell.org/cabal/users-guide/).

**Follow the [Halcyon tutorial](https://halcyon.sh/tutorial/) to get started.**

Usage
-----

Halcyon provides the [`halcyon install`](https://halcyon.sh/reference/#halcyon-install) command, which can be used to install Haskell apps:

```
$ halcyon install https://github.com/mietek/halcyon-tutorial
```

### Installation

Halcyon can be installed by cloning the [Halcyon source repository](https://github.com/mietek/halcyon):

```
$ git clone https://github.com/mietek/halcyon
```

Alternatively, you can run the [Halcyon setup script](https://github.com/mietek/halcyon/blob/master/setup.sh), which also installs the necessary OS packages and sets up the environment:

```
$ eval "$( curl -sL https://github.com/mietek/halcyon/raw/master/setup.sh )"
```

### Documentation

- **Start with the [Halcyon tutorial](https://halcyon.sh/tutorial/) to learn how to deploy a simple Haskell web app using Halcyon.**

- See the [Halcyon reference](https://halcyon.sh/reference/) for a complete list of available commands and options.

- Read the [Haskell on Heroku tutorial](https://haskellonheroku.com/tutorial/) to learn how to deploy Haskell web apps to [Heroku](https://heroku.com/).

#### Internals

Halcyon is written in [GNU _bash_](https://gnu.org/software/bash/), using the [_bashmenot_](https://bashmenot.mietek.io/) library.

- Read the [Halcyon source code](https://github.com/mietek/halcyon) to understand how it works.

About
-----

Made by [Miëtek Bak](https://mietek.io/). Published under the [MIT X11 license](https://halcyon.sh/license/).