# Forest Server

A live-updating development server for [forester](https://git.sr.ht/~jonsterling/ocaml-forester).

## Usage

To make use of the live-reload feature, you will need to add the following
javascript snippet to the root template in `forest.xsl`:

```html
...
<script type="module" src="forester.js"></script>
<script src="reload.js"></script>
```

Run `forest watch -- "$args"`, where `$args` are the arguments you want to pass
to `forester`. For example:

`forest wach -- "build --dev --root index trees/"`

## Installation and Setup

`cargo install forest-server`

Requires `forester` to be available in `$PATH`.

To install using Nix:

```nix
{
  inputs = {
    forester.url = "sourcehut:~jonsterling/ocaml-forester";
    forest-server.url = "github:kentookura/forest-server";
    forester.inputs.nixpkgs.follows = "nixpkgs";
  };

  outputs = inputs@{ self, forester, forest-server, nixpkgs }:
    let
      system = "x86_64-linux"; # Only works on linux so far, PRs welcome!
      pkgs = import nixpkgs { inherit system inputs; };
    in
    {
      devShells.${system}.default = pkgs.mkShell {
        buildInputs = [
          forester.packages.${system}.default
          forest-server.packages.${system}.default
        ];
      };
    };
}
```

### TODO

- Add a nice overlay to the UI like in vite.

## Contributing

Contributions are welcome! Feel free to open a PR.