Stop committing the built widget assets

.github/actions/build-js/action.yml

@@ -0,0 +1,18 @@
+name: Build JS applet
+description: Install Node deps and build the widget JS/CSS assets into the python-wrapper resources.
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Node
+      uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+      with:
+        node-version: "lts/*"
+        cache: yarn
+        cache-dependency-path: js-applet/yarn.lock
+
+    # The built assets are not committed; the package needs them on disk to
+    # build the wheel/sdist and to import the widget in tests.
+    - name: Build JS applet
+      shell: bash
+      run: ./scripts/build_js_applet.sh

.github/workflows/gds-integration-tests.yml

@@ -37,6 +37,9 @@ jobs:
       - name: Install just
         uses: extractions/setup-just@53165ef7e734c5c07cb06b3c8e7b647c5aa16db3 # v4
 
+      - name: Build the JS applet
+        uses: ./.github/actions/build-js
+
       - name: Run tests
         env:
           AURA_API_CLIENT_ID: 4V1HYCYEeoU4dSxThKnBeLvE2U4hSphx

.github/workflows/release.yml

@@ -110,9 +110,18 @@ jobs:
           python-version: "3.11"
           enable-cache: true
 
+      - name: Build the JS applet
+        uses: ./.github/actions/build-js
+
       - name: Build release distributions
         run: uv build
 
+      # setuptools silently omits missing package data, so a forgotten JS build
+      # would publish a broken wheel; fail before uploading to PyPI. Importing
+      # the built wheel in a clean env reuses the widget's own asset guard.
+      - name: Smoke-test the wheel imports
+        run: uv run --no-project --with "$(ls dist/*.whl)" python -c "import neo4j_viz"
+
       - name: Publish to PyPI
         env:
           UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/render-docs.yml

@@ -33,6 +33,10 @@ jobs:
         with:
           python-version: "3.11"
           enable-cache: true
+
+      - name: Build the JS applet
+        uses: ./.github/actions/build-js
+
       - run: uv sync --group dev --group docs --extra pandas --extra neo4j --extra gds --extra snowflake
 
       - name: Setup pandoc

.github/workflows/snowflake-integration-tests.yml

@@ -34,6 +34,10 @@ jobs:
         with:
           python-version: "3.11"
           enable-cache: true
+
+      - name: Build the JS applet
+        uses: ./.github/actions/build-js
+
       - run: uv sync --group dev --extra pandas --extra snowflake
 
       - name: Run tests

.github/workflows/unit-tests.yml

@@ -9,6 +9,9 @@ on:
     paths:
       - "python-wrapper/**" # python code + its resources
       - "python-wrapper/pyproject.toml" # dependencies
+      - "js-applet/**" # built assets are needed to import the widget
+      - "scripts/build_js_applet.sh"
+      - ".github/actions/build-js/**"
     branches: ["main"]
 
   # Allows you to run this workflow manually from the Actions tab
@@ -38,6 +41,10 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           enable-cache: true
+
+      - name: Build the JS applet
+        uses: ./.github/actions/build-js
+
       - run: uv sync --group dev --extra pandas --extra neo4j --extra gds --extra snowflake
 
       - name: Run tests

CONTRIBUTING.md

@@ -64,6 +64,16 @@ just py-sync
 
 This will install all required dev dependencies and install the package in editable mode.
 
+The built widget assets (JS/CSS under `python-wrapper/src/neo4j_viz/resources/`) are
+not committed. Build them with:
+
+```sh
+just js-build
+```
+
+`just py-test` and the CI workflows build them automatically; importing the widget
+without them fails with a reminder to run `just js-build`.
+
 
 ## Specifically for this project
 

changelog.md

@@ -14,3 +14,5 @@
 - Reduce the widget payload.
 
 ## Other changes
+
+- Stop committing the built widget JS/CSS assets; they are now built by `just js-build` and in CI, and the shipped Streamlit stylesheet no longer duplicates the widget's.

justfile

@@ -47,6 +47,7 @@ py-style-gds version="2.0":
     UV_NO_SYNC=1 MYPY_TARGETS=python-wrapper/src ./scripts/checkstyle.sh
 
 py-test:
+    just js-build
     cd python-wrapper && uv sync --all-extras --group dev
     cd python-wrapper && uv run --group dev pytest
 

python-wrapper/.gitignore

@@ -3,6 +3,8 @@ __pycache__
 build
 dist
 
-src/neo4j_viz/resources/*/assets
-/src/neo4j_viz/resources/nvl_entrypoint/*Layout.worker*.js
+# built widget assets (generated by `just js-build`; bundled into the wheel/sdist
+# at build time, never committed)
+src/neo4j_viz/resources/nvl_entrypoint/*
+src/neo4j_viz/resources/streamlit_v2/*
 out/*

python-wrapper/pyproject.toml

@@ -112,7 +112,6 @@ neo4j_viz = [
     "resources/nvl_entrypoint/style.css",
     "resources/nvl_entrypoint/index.html",
     "resources/streamlit_v2/graph.js",
-    "resources/streamlit_v2/style.css",
     "py.typed"
 ]