Migrating from Noodl hosted Git
Introduction
Any Noodl projects created in the closed source (CS) version need to be migrated from Noodls hosted Git to its own Git repository. If you downloaded Noodl after January 2024 you are probaly running the open source (OS) version, and can disregard this guide.
The process of migrating is as follows:
Get in sync
To not lose any of your work you need to sync all the branches in your project. This makes sure that they are up to date on your computer.
To do so, open your project in CS Noodl. Then open the Version Control panel, and pull any potential changes on every branch. If you have any local changes that are unpushed you will need to push them.
Learn more about the Version Control panel in the version control docs.
Move the project
CS Noodl projects live in system folders that are pretty cumbersome to navigate to. A strong suggestion is to move your project to an easily accessible folder.
Open the Project Settings panel and click the "Open project folder" button.
This will open up your file browser in the folder of the current project. Rename this folder into something better and move it to a more reasonable place on your computer.
Gotta get Git
With all branches synced and the project folder moved it's time to give them a new home. For this you will be using Github.
If you dont have a Github account already, now is the time to create one.
Log in to Github and create a new repository. In order to migrate the project you will need two pieces of information from Github:
Git Origin URL
This is found in the repo in the "Quick Setup" section:
Noodl will clear out the newly created repo when pushing. However, to be on the safe side, make sure to create the repo without any README.md or .gitignore files.
Personal Access Token
This is managed in your Github account settings. You can find a guide on it here. The token can be set up to access all your repos, or a select few. Usually, allowing access to all repos is fine, but there are some security benefits in creating separate tokens for each repo. Do what works best for you, but make sure your token is able to access your newly created repository.
Hooking it up
When you have your Git Origin URL and Personal Access Token you can close CS Noodl and open your project in OS Noodl (this is why it's good to have moved the project folder beforehand). When you navigate to the Version Control panel you will now see a migration notice. Click the notice and follow the steps in the popup: