Create your own BIBBOX App

Creating a BIBBOX App

Starting with an existing open-source software solution that handles data, one can easily transform it into a BIBBOX App, following the tutorial at

Each BIBBOX App must be published in the BIBBOX GitHub repository, by creating a repository named app-nameofapp. The repository app-template aims to guide users when creating an App.

Briefly, the most important components of a BIBBOX App are: 

  • The Base Docker is a container created from a Docker Image of the existing software tool. The officially published Docker Image of the software can be used. If none is available, a Dockerfile of the Docker Image should be stored in a BIBBOX GitHub repository named img-nameofdocker and the Docker Image published in the BIBBOX Docker Hub.
  • Additional Docker Containers of the App, such as databases, can be integrated with the Docker Image of the Base Docker, resulting in a docker-compose file, which should be published in the app-nameofapp repository. The Docker Images of the additional Docker Containers can, if necessary, be published in the BIBBOX GitHub repository and in the BIBBOX Docker Hub.
  • The FAIR Data Point is recommended for Apps that handle data, in order to make the data FAIR. For the extension of an App with a FAIR Data Point (FDP), the different components of the FDP are combined into a Docker Image and published in the BIBBOX Docker Hub. As many Apps do not internally support FDPs, the appropriate metadata of the App must be extracted and transformed by the middleware and then loaded into the FDP.

Understanding stakeholders

The following figure shows STAKEHOLDERS and DATA OBJECTS of a typical biobank. As a further step, every stakeholder and data object could have a unique ID. We would suggest distinguishing between:

  • Data objects directly related to a patient/donor.
  • Data objects generated by a study or medical event.
  • Data objects related to a sample or aliquot.