/esgleam

`esbuild` for Gleam (no NodeJS/Deno needed)

Primary LanguageGleamApache License 2.0Apache-2.0

esgleam

Package Version Hex Docs

esbuild for Gleam that works on Erlang & JavaScript.

Quick start

  1. Create a Gleam project as you would normally and make sure you have a file in src with the name of your project (as specified in gleam.toml)

  2. Install esbuild

$ gleam run -m esgleam/install
$ gleam run -m esgleam/bundle

See /dist for your bundled code

  1. To start a development server
$ gleam run -m esgleam/serve

Advanced Usage

(Follow steps 1-2)

  1. Create /src/build.gleam with the following
import esgleam

pub fn main() {
   esgleam.new("./dist/static")
   |> esgleam.entry("main.gleam")
   |> esgleam.target("esnext")
   |> esgleam.target("firefox110")
   |> esgleam.bundle
}
  1. Run your build script
$ gleam run -m build

Installation

If available on Hex this package can be added to your Gleam project:

gleam add esgleam

and its documentation can be found at https://hexdocs.pm/esgleam.

Roadmap

  • Create file watcher for *.gleam which runs on both Erlang and JavaScript
  • Fix bug with STDOUT/STDERR not being shown when running esbuild in the erlang target
  • Write tests for config options
  • Add more config options if needed
  • Pseudo-SourceMaps until #1341 merges
  • Consider creating a way to use plugins
  • Hot Module Reloading?????