We can migrate our Catalyst project from the GitHub Repository to the Catalyst development environment using the Github workflow. You can learn more about the GitHub workflows here.

 Pre-requisites:

1. Before setting up make sure you have the following data for your catalyst project
• catalyst token
• Catalyst project name
• Catalyst Project Org ID
2. To know how to set up a catalyst project, you can try this tutorial on a simple web application.
3. You need to generate a CLI token for executing commands for your user account from Catalyst CLI by executing the following command:

• This will initiate the token generation process. The CLI will display a URL that you can visit from any device. It will also generate a device verification code, which you must enter on the web page of the URL.
• Navigate to the URL displayed in the CLI and enter the verification code. Click Verify. The code will only be valid for five minutes.
• Once your device's CLI is verified, the token will be generated and displayed in your CLI.Do make a copy of that token.

1. You can find your Catalyst Project name and Catalyst Org ID from the Catalyst Console Homepage: "https://console.catalyst.zoho.com/baas/{OrgID}/index"
   

CI/CD Setup:

1. Navigate to the main branch of your GitHub repository where you stored your Catalyst project and create a Workflow Directory .github/workflows and create a YAML file called main.yml under the directory .github/workflows which contains the script code to run the workflow
2. To know more about GitHub workflows kindly refer here.
3. After setting up the runners based on your preference you need to paste the below code based on the type of functions your catalyst application is going to run on.

1. name: Create Release
2. on:
3.   push:
4.     branches:
5. - 'main' 
6. jobs: build: 
7.     runs-on: ubuntu-latest
8.     steps:
9.       - uses: actions/checkout@v1
10.       - name: Loading Node.js
11.         uses: actions/setup-node@v2
12.         with:
13.           node-version: '18'
14. 
    
15.       - name: Loading Java17
16. uses: actions/setup-java@v4.0.0
17. with:
18.     java-version: '17'
19.       distribution: 'oracle'
20.       - name: Setup Python3.9
21. uses: actions/setup-python@v5.0.0
22. with:
23.       python-version: '3.9.15'
24.       - name: Installing catalyst
25. run : npm i -g zcatalyst-cli
26.       - name: Installing Packages for 'Node'
27. run: cd functions/{your function name}/ && npm install --omit=dev
28.       - name: Deploying code to catalyst
29. run: catalyst deploy --project ${{secrets.CATALYST_PROJECT_NAME}} --org ${{secrets.CATALYST_ORG}} --token ${{ secrets.CATALYST_TOKEN}}