Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Publish fork of GitHub project to new NPM module but keep option to merge with original?

Tags:

A high quality open source repo exists on GitHub and NPM, with a wide user base.

I've forked the project and made a substantial extension. I think is ready to merge back. But (appropriately) its the project owner who gets to make that call not me. And it's now been several weeks without reply.

Several users have asked on the repo issue discussion that this be merged back, and more have contacted me directly to publish to NPM as a separate project.

Serious developers can get the new version via GitHub, but it has just the raw source, not the catenated/minified/tailored versions as the README says not to run make dist until it's merged back and the version number incremented.

I think it should be as simple as creating a fork of this fork, and publishing that as a new NPM module. But GitHub doesn't allow me to do that ("You're already looking at this project")

Is there a way that I can publish this as a new NPM module, but still retain the options for

  1. my fork to submit a pull request to the original
  2. my fork to fetch upstream changes from the original
  3. my sub-fork to fetch upstream changes from my fork (and thus the original)

Do I create a new GitHub account under a new email address?

Forking a fork of my repo in GitHub

like image 486
prototype Avatar asked Jun 12 '15 03:06

prototype


People also ask

Can you publish a forked repo?

You can just use your existing fork and keep 2 branches: a "stable" branch that you publish to npm, and a work-in-progress branch that constantly syncs changes with the original project. @user2943490 your comment is the answer. It is possible to publish a branch of a repo (other than master ) to npm and bower.

How do I sync my original forked repo?

To sync your forked repo with the parent or central repo on GitHub you: Create a pull request on GitHub.com to update your fork of the repository from the original repository, and. Run the git pull command in the terminal to update your local clone.

Can you merge a fork in GitHub?

This can be done by simply clicking the pull request button on the GitHub page of your fork. The owner of the original repository will then be notified of your changes and may merge them. In the best case (when there are no merge conflicts), he can do this by simply clicking the “merge” button.


2 Answers

How to fork & patch npm modules

  1. Fork the project on GitHub.
  2. Clone the fork to your machine
  3. Fix the bug or add the feature you want.
  4. Push your commits up to your fork on GitHub (Use a branch if you wish to create a PR for the original repo).
  5. Open your fork on GitHub, and find and copy the SHA of the latest commit you made.
  6. Open up your package.json file, and replace MODULE, USER, REPO, and SHA with the info from the GitHub repo.

    "MODULE": "https://github.com/USER/REPO/tarball/SHA", 

    eg: to get a tarball link from this commit

    "react-remarkable": "https://github.com/HelloKip/react-remarkable/tarball/9549e776136096b827f3a0823329ad997416e364", 
  7. Run npm i to install the module dependencies.

  8. Profit!

Adapted from debuggable.com and cmwelsh.com.

like image 54
Beau Smith Avatar answered Sep 29 '22 10:09

Beau Smith


@user2943490 gave you the correct solution to use branches instead of additional forks.

Let me expand this to answer your questions about still being able to being able to push or pull in several directions. The way git, or rather its data structures, are designed makes it so that you can always push and pull between arbitrary repositories, no matter what. It makes no difference even if they never had a common ancestry.

Yes, you can get wild conflicts, and obviously if you try to merge completely unrelated files, chaos will likely ensue, but it will still be possible. Git only ever cares about the actual contents of the files, not about where they were forked from.

In your example, as you will have common commits with the upstream, it won't ever be a problem.

like image 25
AnoE Avatar answered Sep 29 '22 09:09

AnoE