{"data":{"prismicDocsCategory":{"data":{"pages":[{"page":{"uid":"what-is-uxpin-merge","document":[{"data":{"title":{"text":"What is UXPin Merge?"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"using-react.js-components","document":[{"data":{"title":{"text":"Using React.js Components"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"creating-a-library","document":[{"data":{"title":{"text":"Creating a Library"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"ai-assisted-merge-integration","document":[{"data":{"title":{"text":"AI-Assisted Merge Integration"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"start-with-a-boilerplate-repo","document":[{"data":{"title":{"text":"Start with a Boilerplate Repo"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"integrating-your-own-components","document":[{"data":{"title":{"text":"Integrating Your Own Components"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"config-file","document":[{"data":{"title":{"text":"Config File"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"webpack-configuration","document":[{"data":{"title":{"text":"Webpack Configuration"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"wrapper-component","document":[{"data":{"title":{"text":"Wrapper Component"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"adjusting-components","document":[{"data":{"title":{"text":"Adjusting Components"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"configuring-the-properties-panel","document":[{"data":{"title":{"text":"Configuring the Properties Panel"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"authoring-and-managing-jsx-presets","document":[{"data":{"title":{"text":"Authoring and Managing JSX Presets"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"cli-tool","document":[{"data":{"title":{"text":"CLI Tool"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"ci-servers","document":[{"data":{"title":{"text":"Connecting code to UXPin (CI & push)"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"version-control","document":[{"data":{"title":{"text":"Version Control"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"patterns","document":[{"data":{"title":{"text":"Patterns"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"tailwind-css-integration","document":[{"data":{"title":{"text":"Tailwind CSS Integration"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"merge-design-system-documentation","document":[{"data":{"title":{"text":"Merge Design System Documentation"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"merge-component-manager","document":[{"data":{"title":{"text":"Merge Component Manager"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"storybook-integration","document":[{"data":{"title":{"text":"Storybook integration"},"visible_in_table_of_content":"true"}}]}},{"page":{"uid":"merge-faq","document":[{"data":{"title":{"text":"Frequently Asked Questions"},"visible_in_table_of_content":"true"}}]}}]}},"prismicDocsPage":{"data":{"title":{"text":"Version Control"},"isVisibleForRobots":"true","body":[{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":null},"content":{"html":"<p>When managing a Design System that is continuously getting updated alongside the product, then you can run into issues of using different design system versions for different prototypes. Ideally, you want to keep your library up to date as much as possible in general, but you also might want to control when to upgrade the design system version.</p><p></p><p>To solve this, Merge’s version control system gives you the flexibility to manage your library version for each project. You can freely and easily switch between different versions you’ve added.</p>"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"Version Control Options"},"content":{"html":"<p>In Merge, you have two options on how you want to select the library version you want to use for a given project: Branch or Version Tag.</p><p></p><p><strong>Branch</strong></p><p>If you are managing library versions with the Branch feature, Prototypes will only automatically update when there is change in the branch you are using.</p><p></p><p><strong>Tag</strong></p><p>Selecting a specific version tag, will mean your prototype is always referencing that specific version and won&#39;t be updated when you update the library. It will only update when you change Tag versions or switch to Branch or Latest.</p>"}}},{"__typename":"PrismicDocsPageBodyTip","slice_type":"tip","primary":{"tip_type":"Info tip mini size","tip_title":"NOTE","tip":{"html":"<p>You can only push a Tag once, you can’t push your component library to UXPin again using the same tag. You will have to specify a new tag.</p>"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"Branch vs Tag?"},"content":{"html":"<p>If you’re in the process of actively making changes to your design system and don’t want to keep changing tags every time you push to test changes, then using Branch is advised.</p><p></p><p>If you’re looking for more control over design system versions, then Tag gives you full control on when to upgrade the design system version.</p>"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"Always Use the Latest Design System Version"},"content":{"html":"<p>Additionally, if you always want to use the latest version of your design system then there is a checkbox to follow “Latest”. Using the latest option will ensure a prototype will be automatically updated whenever there is a change in the library as it is always referencing the latest version of the branch.</p>"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"Adding Tag Versions To Your Library"},"content":{"html":"<p>Specify `--tag` option at push from CLI</p>"}}},{"__typename":"PrismicDocsPageBodyCode","slice_type":"code","primary":{"code":{"raw":[{"text":"npx uxpin-merge push --token TOKEN --tag VERSION"}]},"language":null}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"Adding Branch Versions To Your Library"},"content":{"html":"<p>Specify `--branch` option if you wish to push working branch</p>"}}},{"__typename":"PrismicDocsPageBodyCode","slice_type":"code","primary":{"code":{"raw":[{"text":"npx uxpin-merge push --token TOKEN --branch branch"}]},"language":null}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"How to switch a version for a prototype?"},"content":{"html":"<p> </p>"}}},{"__typename":"PrismicDocsPageBodyVideo","slice_type":"video","primary":{"video_link":{"url":"https://uxpincommunity.cdn.prismic.io/uxpincommunity/b1cc8568-05e9-47f9-baed-7e86b8939647_01_manage.mp4"},"video_description":{"text":"How to switch a version for a prototype"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":null},"content":{"html":"<ol><li>Click gear icon while you open merge library you would like to control</li><li>Click “Manage Version in project” on library panel</li><li>Choose the version you want to use for a prototype</li></ol>"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":"How to set a default version for future prototypes?"},"content":{"html":"<p> </p>"}}},{"__typename":"PrismicDocsPageBodyVideo","slice_type":"video","primary":{"video_link":{"url":"https://uxpincommunity.cdn.prismic.io/uxpincommunity/30e52ad2-6aeb-43b0-9dfd-8612f8ca1514_02_library.mp4"},"video_description":{"text":"How to set a default version for future prototypes"}}},{"__typename":"PrismicDocsPageBodyContent","slice_type":"content","primary":{"content_title":{"text":null},"content":{"html":"<ol><li>Click gear icon while you open merge library you would like to control</li><li>Click “Library settings” on library panel</li><li>Choose the version you want to use for future prototypes</li></ol>"}}}]}}},"pageContext":{"isCreatedByStatefulCreatePages":false,"categoryUid":"merge","pageUid":"version-control","meta_description":"UXPin's merge Docs, version control for new and advanced users","meta_image":"https://images.prismic.io/uxpincommunity/fa3875f8df8606e6405ba46165becc1ea6ed3d34.png?auto=compress,format","meta_title":"Version Control | Merge","page_title":"Version Control | Merge"}}