Lucent-Pack

Pack a Shiny app and a WebAssembly R environment into a static site.

Installation

pip install lucent-pack
# OR
micromamba install lucent-pack

Usage

1. Create a wasm environment with your favorite package manager.

micromamba create -f environment.yaml --platform=emscripten-wasm32

# Sample environment.yaml
name: shinyapp-env
channels:
- https://repo.prefix.dev/emscripten-forge-4x
- conda-forge
dependencies:
# Minimum requirements
- r-main
- r-shiny
# Any additional packages required for the app
- r-bslib
- r-plotly

2. Build the site.

lucent build --prefix-dir /path/to/wasm/env/ --app /path/to/app --outdir ./_site

3. Check results.

lucent serve ./_site # the output directory

Development

Requirements:

• python
• pip
• nodejs

pip install -e .

# Browser runtime — required before `python -m build` (wheel)
cd js && npm ci && npm run build
mkdir -p ../src/lucent_pack/static/lucent/dist
cp -a dist/. ../src/lucent_pack/static/lucent/dist/

The hatch wheel hook fails the build if the bundles (src/lucent_pack/static/lucent/dist/) are missing.

CLI