What is Sync?

Radical.sh allows code to be explored and downloaded. However, the download option becomes challenging to manage when users execute code and need to make subsequent changes in Radical.

Sync Advantage

Instead of repeatedly downloading the entire project when making changes, Radical.sh provides a solution: Sync.

Sync Limitations

1. Sync is available in Chrome only and uses the file system API to sync changes.
2. Warning! - Radical.sh always overwrites any local changes made in this folder / branch. While this might seem like a limitation, it keeps a clear branch for automated changes.

Steps for Using Sync

1. Create a git repository, ensure the git repo name matches project name in radical. Radical converts project all characters to lower case and replace spaces with hypens. For example, if your project is named as Order Service in radical, create repo with order-service as name.
2. If you already have a repo with this name, just clone it in your local system.
3. Create an orphan branch for radical git switch --orphan radical. This provides clean starting point to track changes for radical
4. Now in radical.sh choose sync and select the folder of git repository.
5. Once sync is complete all the files should be downloaded to local in radical branch.
6. Add all files and commit

git add -A

git commit -m "Initial Radical.sh Changes"

7. Radical.sh changes are always available in radical branch and you can pull or merge on to your working branch when ever needed.

git checkout <your_branch_name>
git merge radical # this brings radical changes to your branch and you can resolve conflicts

If any other modifications are made in to radical.sh website, following steps can be used to perform to bring the changes to your local branch and resolve conflicts against your working branch

git checkout radical # ensure your are in radical branch

Perform sync step from radical website

git add -A

git commit -m "More changes from radical.sh website"