Skip to content
This repository was archived by the owner on Apr 7, 2026. It is now read-only.

CONTRIBUTING.md

Latest commit

 

History

History
123 lines (84 loc) · 5.25 KB

CONTRIBUTING.md

File metadata and controls

123 lines (84 loc) · 5.25 KB

Contribution Guidelines

Note: If these contribution guidelines are not followed your issue or PR might be closed, so please read these instructions carefully.

See also: the Invertase code of conduct

About

Globe is a global deployment platform for Dart & Flutter applications.

Contribution types

Bug Report

  • If you find a bug, please first report it using GitHub issues.
    • First check if there is not already an issue for it; duplicated issues will be closed.

Bug Fix

  • If you'd like to submit a fix for a bug, please read the How To for how to send a pull request.
  • Indicate on the open issue that you are working on fixing the bug and the issue will be assigned to you.
  • Write Fix #xxxx in your PR text, where xxxx is the issue number (if there is one).
  • Include a test that isolates the bug and verifies that it was fixed.

New Features

  • If you'd like to add a feature to the library that doesn't already exist, feel free to describe the feature in a new GitHub issue.
  • If you'd like to implement the new feature, please wait for feedback from the project maintainers before spending too much time writing the code. In some cases, enhancements may not align well with the project future development direction.
  • If applicable, implement the code for the new feature and please read the How To.

Documentation & Miscellaneous

  • If you have suggestions for improvements to the documentation or examples (or something else), we would love to hear about it.
  • As always first file a GitHub issue.
  • Implement the changes to the documentation, please read the How To.

How To Contribute

Requirements

Forking & cloning the repository

  • Ensure all the dependencies described in the previous section are installed.
  • Fork https://github.com/invertase/globe into your own GitHub account. If you already have a fork, and are now installing a development environment on a new machine, make sure you've updated your fork so that you don't use stale configuration options from long ago.
  • git clone git@github.com:<your_name_here>/globe.git
  • git remote add upstream git@github.com:invertase/globe.git (So that you fetch from the main repository, not your clone, when running git fetch or git pull

Local development setup

This repository uses a tool called Melos to manage packages and dependencies, to set it up, run the following command from your terminal:

dart pub global activate melos

Next, at the root of your locally cloned repository bootstrap the projects dependencies:

melos bootstrap

The bootstrap command locally links all dependencies within the project without having to provide manual dependency_overrides. This allows all plugins, examples and tests to build from the local clone project. You should only need to run this command once.

You do not need to run dart pub get once bootstrap has been completed.

After bootstrapping, run the follwing command to get the latest graphql schema.

melos run download-schema

To activate the Globe CLI for local development, run the following command inside the package directory:

dart pub global activate --source="path" . --executable="globe"

Performing changes

  • Create a new local branch from main (e.g. git checkout -b my-new-feature)
  • Make your changes (try to split them up with one PR per feature/fix).
  • When committing your changes, make sure that each commit message is clear (e.g. git commit -m 'docs: Add CONTRIBUTING.md').
  • Push your new branch to your own fork into the same remote branch (e.g. git push origin my-username.my-new-feature, replace origin if you use another remote.)

Publishing changes

  1. Switch to main branch locally.
  2. Run git pull origin main.
  3. Run git pull --tags to make sure all tags are fetched.
  4. Run melos version to automatically version packages and update Changelogs.
  5. Run melos publish to dry run and confirm all packages are publishable.
  6. Run melos publish --no-dry-run
  7. Run git push --follow-tags to ensure the release is pushed to GitHub.

Open a pull request

To send us a pull request:

  • Go to https://github.com/invertase/globe and click the "Compare & pull request" button

Please make sure all your check-ins have detailed commit messages explaining the patch.

When naming the title of your pull request, please follow the Conventional Commits guide.

Please also enable “Allow edits by maintainers”, this will help to speed-up the review process as well.