5 releases

0.2.2 Dec 11, 2023
0.2.1 Dec 4, 2023
0.2.0 Dec 4, 2023
0.1.1 Nov 30, 2023
0.1.0 Nov 29, 2023

#653 in HTTP server

49 downloads per month

MIT license

26KB
316 lines

Forest Server

A live-updating development server for 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:

...
<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:

{
  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.

Dependencies

~24–37MB
~603K SLoC