DEV Community ๐Ÿ‘ฉโ€๐Ÿ’ป๐Ÿ‘จโ€๐Ÿ’ป

Danielle Heberling
Danielle Heberling

Posted on • Originally published at danielleheberling.xyz on

Improved git workflows with graphite.dev

Github on a computer screen

Photo by Richy Great on Unsplash

Current Landscape

Git is a tool that many tech people use. Itโ€™s great for the most part. There are some pain points that could improve the experience. My issues revolve around collaboration with others. Hereโ€™s some examples.

As someone requesting a code review, so I can merge my changes:

  • waiting for someone to review my code
  • merge conflicts due to a PR being open for very long
  • sometimes the code in the PR is needed for next steps

As someone doing code reviews for my teammates:

  • it can be unclear which PRs I need to review or re-review
  • navigating very long PRs

Solution

Upon joining my most recent company, my onboarding buddy told me about how they use graphite.

Graphite utilizes something theyโ€™re calling a โ€œstack.โ€ What used to be one huge PR is now many branches that build off of each other with each branch being its own PR.

PR comment of a stack

Sounds great as someone who has to review code, but as the code submitter I had some concerns about what happens when merging branches. Would I get lots of merge conflicts? So far while using graphite, the answer has been mostly no. Graphite has a cli command that pulls down changes from the upstream and automatically rebases all affected branches.

gt repo sync --restack
Enter fullscreen mode Exit fullscreen mode

A nice bonus is that this command also prompts to ask if you want to delete local branches that have been merged into the main branch.

Another benefit is that graphite has a nice web based UI where you can see which PRs need your input both as a PR submitter and reviewer.

Summary

Despite all of the custom cli commands, graphite uses git under the hood. If you want to do something with vanilla git, graphite will pass that command through to git directly. One con to using graphite is that it just appears to work with Github (for now?). Also, at the time of writing this, thereโ€™s a waitlist to get on the app.

Thereโ€™s many more cli commands and features that I did not cover. Much like git, people have their preferred workflows and thereโ€™s many more commands/options than one would use in their daily workflow.

Disclaimer that I was not paid nor asked to write this post. I personally found this tool helpful. Thought Iโ€™d share about how itโ€™s helped me with the intent that it might also help you.

Top comments (2)

Collapse
 
flous profile image
Luc Geurts

Thanks for this post. Am for sure going to give it a try.

Classic DEV Post:

Understanding git through images