PDBe Molstar

PDBe implementation of Mol* (/'mol-star/)

Refer PDBe Molstar Wiki for detailed documentation and examples

Building & Running locally

npm install
npm run build
# npm run rebuild  # for a clean build
npm run serve

Build automatically on file save:

npm run watch

Manual testing

• Run locally by npm run serve
• Go to http://127.0.0.1:1338/portfolio.html and check the viewer with various different setting (some of these reflect the actual setting on PDBe pages)
• If you want to tweak the options, go to "Frame URL" and change the options in the URL

Deployment

• Bump version in package.json using semantic versioning
  • Use a version number like "1.2.3-beta.1" for development versions (to be used in development environment wwwdev.ebi.ac.uk)
  • Use a version number like "1.2.3" for proper releases
• Ensure install, lint, and rebuild works locally
• Update CHANGELOG.md
• Git commit and push
• Create a git tag matching the version with prepended "v" (e.g. "v1.2.3")
• The GitHub repo will automatically be mirrored to EBI GitLab (might take up to 1 hour)
• CICD pipeline in EBI GitLab will automatically publish the package to npm (https://www.npmjs.com/package/pdbe-molstar)
• The files will become available via JSDeliver
  • Latest version including development versions:
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@dev/build/pdbe-molstar-plugin.js
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@dev/build/pdbe-molstar-component.js
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@dev/build/pdbe-molstar.css
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@dev/build/pdbe-molstar-light.css
  • Latest proper release:
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@latest/build/pdbe-molstar-plugin.js
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@latest/build/pdbe-molstar-component.js
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@latest/build/pdbe-molstar.css
    • https://cdn.jsdelivr.net/npm/pdbe-molstar@latest/build/pdbe-molstar-light.css
• Go to https://www.jsdelivr.com/tools/purge and purge the cache for abovementioned URLs (otherwise it might take up to 7 days to before @latest starts pointing to the new version)