Skip to content

The official Flutter Community Transfer Guide for package maintainers wanting to transfer their package to the organization.

Notifications You must be signed in to change notification settings

fluttercommunity/transfer-guide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 

Repository files navigation

Flutter Community Transfer Guide

Thank you for your interest in the Flutter Community! We look forward to receiving and featuring your package.

To ensure all packages added are listed properly, there are a few steps you must take before your package can be added to the Flutter Community.

With these steps, you can migrate your package over to the Flutter Community GitHub organization.

  1. Create an issue on Flutter Community
  2. Get approval from a moderator
  3. Update pubspec.yaml
  4. Update the CHANGELOG.md and README.md
  5. Add Flutter Community as Pub uploader
  6. Publish your changes to Pub
  7. Notify the Flutter Community Team
  8. Transfer the package to Flutter Community

1: Create an issue on Flutter Community

Before you can move your package over to the community organization, you first need to submit it by creating an issue and filling out the template.

Once you’ve completed the submission form, verify that all fields have been properly filled out and then submit the ticket.

2: Get approval from a moderator

After you’ve opened a ticket, a member of the Flutter Community team will review your package and decide whether to accept or reject your submission. Don’t worry, if it gets rejected, you’ll get feedback and will know what changes you could make to get it re-reviewed.

Factors such as code quality, documentation, comments and especially pub.dev scores all determine whether or not your package is accepted, so please make sure your package looks its best when submitting your request!

3: Update pubspec.yaml

Now that your package has been accepted to Flutter Community, there are a few changes you need to make to your pubspec.yaml file.

Add the maintainer field to your pubspec.yaml.

Only one maintainer is currently supported. Format the value like the example below:

...
maintainer: YOUR-NAME (@YOURGITHUBUSERNAME)
...

For an example on what a complete pubspec.yaml should look like, check out this file from the package after_layout.

4: Update the CHANGELOG.md and README.md

Congratulations, you’ve updated your package and you’re almost finished.

(If you don’t yet have a CHANGELOG.md file in your package’s repository, please create one now. For an example on how to use and keep a changelog, check keepachangelog.com.)

Update the CHANGELOG.md to include the following entry (or something similar to it):

- Moved package to Flutter Community

Next, in your package’s README.md, add the Flutter Community package banner by adding the following piece of text at the top of the file and change PACKAGE_NAME to the title of your package:

[![Flutter Community: PACKAGE_NAME](https://fluttercommunity.dev/_github/header/PACKAGE_NAME)](https://github.com/fluttercommunity/community)

(If the banner doesn't display properly, don't worry - It will show up properly at a later date.)

Once you’ve done that, add your changes and commit them back to your repository.

5: Add Flutter Community as Pub uploader

Last but not least, add community@flutter.zone as an uploader on Dart Pub. This can be done using the following command:

flutter packages pub uploader add community@flutter.zone

6: Publish your changes to Pub

Finally, save your changes and push your updated files to Pub. (Usually, this is done through running flutter packages publish.)

7: Notify the Flutter Community team

Once you've made all the necessary changes above, please notify the member of the team who reviewed your package in the original package proposal issue. They will review your changes and add you as a member of the Flutter Community's GitHub.

8: Transfer the package to Flutter Community

Now that you’re a member of Flutter Community’s GitHub organization, you can transfer your package repository.

Navigate to settings in your package GitHub’s repository, scroll to “Danger Zone” then select “Transfer repository”. After selecting this option, you will be presented with a pop up dialog prompting you to enter your repository name and the name of the GitHub organization you’d like to move the package to. For the second option, enter the name fluttercommunity.

If you would like a more detailed guide for transferring GitHub repositories, please see https://help.github.com/en/articles/transferring-a-repository

Once you have transferred your package, please contact us on the package transfer issue from before.

You’re done!

Thank you for taking the time to transfer your package.

If you have any questions, feel free to ask for help in your package transfer issue or open a new issue on the /community repository.

Sincerely,
- The Flutter Community Team.

About

The official Flutter Community Transfer Guide for package maintainers wanting to transfer their package to the organization.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published