Skip to content

Latest commit

 

History

History
63 lines (43 loc) · 2.33 KB

README.md

File metadata and controls

63 lines (43 loc) · 2.33 KB

Web app to generate Scala 3 Native bindings for C

Warning: this is currently not working and really should be a private repo, but I've run out of private GHA minutes so... here we are

2023-05-29 12 01 15

Quick start (Docker)

Warning: this will take some time, as we need to build NGINX Unit from scratch, and install LLVM. Sit back, have a beverage

  • Build a docker container

    Release version (slow):

    $ docker build . --build-arg scalanative_mode=release-fast --build-arg scalanative_lto=none -t sn-bindgen-web
    

    Debug version (slightly faster):

    $ docker build . --build-arg scalanative_mode=debug --build-arg scalanative_lto=none -t sn-bindgen-web
    
  • Run it

    docker run -p 9999:9999 sn-bindgen-web:latest
    
  • Open http://localhost:9999 and enjoy.

Local development (backend)

  1. Install NGINX Unit: https://unit.nginx.org/installation/

  2. Install LLVM: https://releases.llvm.org/

  3. Set LLVM_BIN env variable to the location of bin folder in LLVM installation

  4. Run sbt devServer/run

    Warning: first run will be very slow. Subsequent ones will be somewhat slow.

    Alternatively, you can keep launch SBT and run devServer/reStart in there - this will make sure that your SBT shell remains usable, and the server will be run in the background.

  5. Open http://localhost:9999 and enjoy.

Local development (frontend)

The frontend module is set up using Vite.js.

  • cd modules/frontend
  • npm install
  • Run the backend (see above), it has to be running on port 9999 (default) as Vite is configured to proxy the /api/* requests to http://localhost:9999/api/*
  • In a separate SBT shell, run ~frontend/fastLinkJS - this continuously rebuilds the Scala.js frontend
  • npm run dev - will run the Vite server
  • Open http://localhost:5173 and you can now edit frontend without restarting the backend, with live reload