Open source software thrives on people’s contributions. We sincerely appreciate your interest in contributing to the MorphoCluster project!

Bug Reports

Bug reports play a vital role! Before submitting a bug report, please take a moment to check the GitHub issues to ensure that the bug hasn’t already been reported.

Code Contributions

Steps for Submitting Code

GitHub Pull Requests are the preferred method for collaborating on code in this project. To contribute, please follow these steps:

  1. Fork the MorphoCluster repository on GitHub and clone your fork locally:

    git clone ...

    (Insert the URL of your fork.)

  2. Configure the the “upstream” remote to be able to get the latest changes from the central repository:

    git remote add upstream

    (This only needs to be done once for each local clone.)

  3. Create a new branch for the fix or feature that you’re about to implement:

    # Switch to "main" branch
    git checkout main
    # Pull the latest changes from the central repository
    git pull upstream main
    # Push the latest changes to your fork (optional)
    git push
    # Create and checkout a new branch named "fix-xy"
    git checkout -b fix-xy

    (fix-xy is a placeholder. Chose a speaking name.)

  4. Implement your changes.

  5. Write meaningful commit messages to document your changes.

  6. Push your local changes to your fork on GitHub:

    git push -u origin fix-xy
  7. Submit a GitHub Pull Request. Your contribution will be reviewed promptly.

  8. It might happen that new changes appear on the upstream main branch. These need to be merged into your feature branch:

    # Pull the latest changes from the central repository
    git pull upstream main

Used frameworks

MorphoCluster currently uses the following (outdated) versions of certain dependencies:

  • Flask v1.1 <> (Not v3!)

  • Vuetify v2 <> (Not v3!)

VS Code Dev Container

The repository contains a VS Code .devcontainer configuration. See the official VS Code documentation: Developing inside a Container.

To build the devcontainer Docker image, BuildKit is required. It is recommended to include the following in your .bashrc:

# Use BuildKit

Running the services

Both the backend (Flask) and frontend (Vue) frameworks support hot reloading. This means that after saving the code from the editor, the services reload automatically and changes should be visible instantaneously. To enable this behavior, open two terminals, one for the backend, one for the frontend.


cd morphocluster/frontend
flask run

# The output looks similar to this:

   * Serving Flask app "morphocluster" (lazy loading)
   * Environment: development
   * Debug mode: on
   * Running on (Press CTRL+C to quit)
   * Restarting with stat
   * Debugger is active!
   * Debugger PIN: XXX-XXX-XXX


cd morphocluster/frontend
npm run serve

# The frontend is built in-place.
# After a while, the output looks similar to this:

   DONE  Compiled successfully in 5040ms

   App running at:
   - Local:   http://localhost:8080/frontend/
   - Network:

   Note that the development build is not optimized.
   To create a production build, run npm run build.

Then, open the address of the frontend in your browser.

Updating dependencies

Dependencies are declared in environment.base.yaml (general) and (development only). Run to regenerate the lock file, then rebuild the devcontainer.

Code Style

To maintain code consistency, please adhere to the following guidelines:

Documentation Contributions

Documentation holds significant value for this library, and we warmly welcome any improvements. The documentation resides in the docs/ directory and is written in reStructuredText. We utilize Sphinx to generate a comprehensive suite of documentation, with napoleon interpreting the docstrings.

To build and preview the documentation, perform the following steps:

cd docs

# Render docs as html
make html

# Start local webserver to display the docs
python -m http.server -d _build/html/