@i-vresse/haddock3-ui

Reusable React components from Haddock3 webapp

https://github.com/i-vresse/haddock3-ui

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.2%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

Reusable React components from Haddock3 webapp

Basic Info
Statistics
  • Stars: 0
  • Watchers: 6
  • Forks: 0
  • Open Issues: 1
  • Releases: 15
Created almost 2 years ago · Last pushed over 1 year ago
Metadata Files
Readme Contributing License Code of conduct Citation

README.md

React components for/from haddock3 webapp

github repo badge npmjs.com CI lint CI test codecov DOI Research Software Directory Badge fair-software.eu Checked with Biome

The haddock3 web application had several components that could be used outside of the web application. This package contains those components.

  • Components to render a 3D molecular structure from PDB file using NGL
  • Components to select residues in a molecule either passive or active
  • Components to handle files
  • Components to render clusters or structures in a sortable table

Installation

bash npm install @i-vresse/haddock3-ui

The components are styled with tailwindcss. For your own webapp to pick up the classes in the components, you need to add the following to your tailwind.config.js:

js /** @type {import('tailwindcss').Config} */ export default { content: [ // Existing content goes here './node_modules/@i-vresse/haddock3-ui/dist/**/*.js', ], // Rest of the config goes here }

If you are not using tailwindss, you can make use the included css file import "@i-vresse/haddock3-ui/dist/index.css" (based on New York neutral shadcn/ui theme).

Usage

Stories of the components can be found at https://i-VRESSE.github.io/haddock3-ui.

See the sidebar for a list of all component stories. Once component is selected - interact with component story - use </> button in footer to see the code. - use sliders icon button in footer to change props when available

API documentation is available at https://i-VRESSE.github.io/haddock3-ui/api/

Direct in browser

The components can be used directly in the browser, without your own build system.

example.html is a clustered table example which uses the latest package version from npm via https://esm.sh/. example-molviewer.html is a simple molecule viewer example.

Offline bundle

The table components are used by the caprieval module of haddock3 to generate report.html. Haddock3 can be used offline, which means after installation the running of haddock3 will be isolated from the Internet.

To use the table components offline, you can build an offline bundle of the components with

```bash

Installs dependencies

pnpm install

Create dist/index.css and dist/report.bundle.js,

which contains the table components and all of its dependencies

pnpm build ```

See example-offline.html for an example of how to use the offline version.

To prevent CORS issues, the html, css and js files should be served from the same http server like with python3 -m http.server and visit http://localhost:8000/example-offline.html.

Owner

  • Name: Interactive Virtual Research Environment for Scientific Software Execution
  • Login: i-VRESSE
  • Kind: organization

Project with Netherlands eScience Center and Bonvin Lab

Citation (CITATION.cff)

cff-version: 1.2.0
title: Haddock3 web application ui components
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Stefan
    family-names: Verhoeven
    affiliation: Netherlands eScience Center
    orcid: "https://orcid.org/0000-0002-5821-2060"
  - given-names: Dusan
    family-names: Mijatovic
    email: d.mijatovic@esciencecenter.nl
    affiliation: Netherlands eScience Center
    orcid: "https://orcid.org/0000-0002-1898-4461"
license: Apache-2.0
identifiers:
  - type: doi
    value: 10.5281/zenodo.12820670
    description: Latest version of software

GitHub Events

Total
Last Year

Packages

  • Total packages: 1
  • Total downloads:
    • npm 23 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 11
  • Total maintainers: 4
npmjs.org: @i-vresse/haddock3-ui

[![github repo badge](https://img.shields.io/badge/github-repo-000.svg?logo=github&labelColor=gray&color=blue)](https://github.com/i-VRESSE/haddock3-ui) [![npmjs.com](https://img.shields.io/npm/v/@i-vresse/haddock3-ui.svg?style=flat)](https://www.npmjs.co

  • Versions: 11
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 23 Last month
Rankings
Forks count: 12.4%
Stargazers count: 16.9%
Average: 23.4%
Dependent repos count: 26.2%
Dependent packages count: 38.0%
Last synced: 11 months ago

Dependencies

.github/workflows/pages.yml actions
  • actions/checkout v4 composite
  • actions/configure-pages v5 composite
  • actions/deploy-pages v4 composite
  • actions/setup-node v4 composite
  • actions/upload-pages-artifact v3 composite
package.json npm
  • @chromatic-com/storybook ^1.6.1 development
  • @storybook/addon-essentials ^8.2.5 development
  • @storybook/addon-interactions ^8.2.5 development
  • @storybook/addon-links ^8.2.5 development
  • @storybook/addon-themes ^8.2.5 development
  • @storybook/blocks ^8.2.5 development
  • @storybook/react ^8.2.5 development
  • @storybook/react-vite ^8.2.5 development
  • @storybook/test ^8.2.5 development
  • autoprefixer ^10.4.19 development
  • postcss ^8.4.39 development
  • storybook ^8.2.5 development
  • tailwindcss ^3.4.6 development
  • tsup ^8.2.2 development
  • typescript ^5.5.3 development
  • clsx ^2.1.1
  • ngl ^2.3.1
  • react ^18.3.1
  • react-dom ^18.3.1
  • tailwind-merge ^2.4.0
.github/workflows/lint.yml actions
  • actions/checkout v4 composite
  • actions/setup-node v4 composite
  • pnpm/action-setup v4 composite
.github/workflows/publish.yml actions
  • actions/checkout v4 composite
  • actions/setup-node v4 composite
  • pnpm/action-setup v4 composite
pnpm-lock.yaml npm
  • 190 dependencies