Skip to content

Latest commit

 

History

History
71 lines (45 loc) · 2.33 KB

File metadata and controls

71 lines (45 loc) · 2.33 KB

Contributing to Allen Institute for Cell Science Open Source

Thank you for your interest in contributing to this Allen Institute for Cell Science open source project! This document is a set of guidelines to help you contribute to this project.

Code of Conduct

By participating in this project, you are expected to uphold our Code of Conduct.

Project Documentation

The README in the root of the repository should contain or link to project documentation. If you cannot find the documentation you're looking for, please file a GitHub issue with details of what you'd like to see documented.

How to Contribute

Typical steps to contribute:

  1. Fork the repo on GitHub.

  2. Create a branch and make your edits on your branch, pushing back to your fork.

  3. Ensure that your changes are working, pass any linting and tests in the project. Add tests and documentation as needed.

  4. Submit a pull request to merge your fork's branch into this repository, via GitHub.

Running locally

install Bun

  1. Instructions
  2. In this repo: bun install

Locally link the viewer (for testing new changes to the viewer, or debugging)

  1. clone the viewer repo
  2. cd into the viewer repo
  3. build the viewer: npm run build
  4. type cat package.json
  5. then bun link
  6. cd back to this repo
  7. type bun link @aics/simularium-viewer

Start the dev server

  1. type bun dev <= starts the server
  2. Open at http://localhost:5173/

React + TypeScript + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

Production deployment

  1. Make a new version: npm version [patch/minor/major]
  2. Push the new package.json version: git push origin main
  3. Push the new tag: git push origin [NEW_TAG]

Questions or Thoughts?

Talk to us on one of our community forums.