We are now using FontAwesome Pro which requires a license. To build the app locally request a TOKEN from the admins and you need to setup an env variable containing it like
export FONTAWESOME_NPM_AUTH_TOKEN=...or
set -x FONTAWESOME_NPM_AUTH_TOKEN ...For auth to work you need your app to run on the lucuma.xyz domain, the simplest way
is to setup /etc/host adding an alias for localhost
127.0.0.1 localhost local.lucuma.xyz
Alternatively if you run a home DNS server you can provide a local alias. This has the benefit of opening testing to any device in the network
First you need to build a copy of the fastLinkJS version of explore
sbt explore/fastLinkJS
To launch explore you can use vite development server going to the explore dir and
calling the command npx vite
You may need to update your node modules via npm install
With that you can open the app at: http://local.lucuma.xyz:8080/
In same cases you may want to test locally how the app looks without deploying. In that case you need to:
- Build a full link version of explore
sbt explore/fullLinkJS
- Build it with vite and launch
npx vite build && npx vite preview
As before you can now see the app locally but in a different port http://local.lucuma.xyz:5000/
Besides doing a full deployment you need to comment out the condition about local.lucuma.xyz on main.jsx
Normally you want to test changes thus you need to do even a tiny change and build again to trigger an update prompt.
For sanity, you may want to uninstall the Service Worker after testing, going to the developer tools and Application -> Service Workers (in Chrome) -> unregister.
You can check the evolution of bundle sizes here