This help guide goes over how to use Ditto with Figma branching.
You can import Figma branches into Ditto like any regular Figma file in the web app or the Figma plugin. Just make sure you copy and paste the branch-specific link to the Figma file! It should look something like this:
Once imported, the Figma branch will look and function like any other Ditto project. You’ll be able to tell that a project is connected to a Figma branch if you see the following badge next to the project name:
At the moment, you can only connect one branch of a Figma file to Ditto at a time. This means that if you’ve already imported the main branch of a Figma file into Ditto, you won’t be able to import another branch. You’ll have to delete the existing project that’s connected to the main branch, and then import your intended branch from scratch as a new project.
When a branch file gets merged or archived in Figma, the next time you open the Ditto project, you’ll get presented with the following modal, asking what you want to do with the changes made in the Figma branch:
You can do one of the following:
Once you’ve chosen one of the above options, the Ditto project will now be connected to the main branch of the Figma file. This means you can use the Ditto Figma plugin in the main branch of the Figma file, like usual.
If you actually want to start from scratch with a different branch, you’ll just need to delete the project and import the branch as a new one.
Note: We currently support Figma branching in a limited capacity. Don’t worry though — more robust support for branching is on our roadmap! If there’s something specific you want to see, we’d love to hear from you. :)