Monaca Docs
  • Monaca
  • Create Your First App
  • Release Notes and Updates
    • Privacy Manifest Requirement for iOS Apps
    • Plugin uses-permission Tag Deduplication Feature
    • iOS Monaca Debugger Discontinuation & Alternative Features
    • Error submitting to iOS App Store (ITMS-90165)
    • Build error in cordova-custom-config
    • Cordova 11 changes
    • Cordova 10 changes
    • Cordova 9 changes
    • New Monaca CLI and Localkit
    • Migration from Cordova to Capacitor
  • Product Guides
    • Monaca Development Overview
    • Monaca Cloud IDE
      • Overview
      • Features in the Monaca Cloud IDE
      • Integrated Terminal
      • Editor Shortcuts
      • Project Dependencies
        • File and Folder Structure
        • JS/CSS Components
        • Cordova Plugins
        • Custom Cordova Plugins
      • Version Control
        • Introduction
        • GitHub Integration
        • Git SSH Integration
      • Monaca CI
        • Overview
        • Deploy Services
        • Deploy to Appetize.io
        • Deploy to DeployGate
        • Deploy to Firebase
      • Build
        • Building for iOS
          • Building an iOS App
          • Build Settings between Monaca and Xcode
        • Building for Android
        • Building for Electron
          • Building on Windows
        • Building for PWA
        • Building for Windows
        • Build Environment Settings
        • Common Build and Application Upload Errors
        • Build History
      • Distribution
        • App Store Distribution
          • App Store Connect Guide
          • iOS App Upload Feature
        • Google Play Distribution
        • Amazon Appstore Distribution
        • Non-market App Distribution
      • Download App Package
      • Tutorial
    • Monaca Localkit
      • Overview
      • Pairing and Debugging
      • Remote Building and Publishing
      • Troubleshooting Guide
      • Tutorial
    • Monaca CLI
      • Overview
      • Monaca CLI Commands
      • Pairing and Debugging
      • Project Dependencies
        • File and Folder Structure
        • JS/JSS Components
        • Cordova Plugins
        • Custom Cordova Plugins
      • Remote Building and Publishing
      • Troubleshooting Guide
      • Tutorial
    • Monaca Debugger
      • Functionalities
      • Installation
        • Monaca Debugger for Android
        • Monaca Debugger for iOS
        • Monaca Debugger for Android Emulator
      • Usage
      • Custom Build Debugger for iOS
      • iOS App Simulator Build
      • Troubleshooting Guide
      • Tutorials
    • Team Dashboard
    • Quick Viewer
    • Migrating from Other Platforms
      • Key Points
      • Cloud IDE preview function settings
      • Migrating from Angular
      • Migrating from Ionic
      • Migrating from React
      • Migrating from Vue
      • Migrating from PhoneGap
        • Key Differences
        • Guide for PhoneGap Build Users
        • Guide for PhoneGap CLI Users
        • Guide for PhoneGap Desktop App Users
      • Migrating from Telerik
  • Build App
    • Build for iOS
      • Creating a Private Key and CSR
      • Creating a Certificate
      • Updating Provisioning Profiles
  • Tutorials
    • Monaca Cloud IDE Tutorial
      • Part 1: Starting a Project
      • Part 2: Running Monaca Debugger with Monaca Cloud IDE
      • Part 3: Building a Monaca App
      • Part 4: Publishing a Monaca App
    • Monaca Localkit Tutorial
      • Part 1: Starting a Project
      • Part 2: Running Monaca Debugger with Monaca Localkit
      • Part 3: Building a Monaca App
      • Part 4: Publishing a Monaca App
    • Monaca CLI Tutorial
      • Part 1: Starting a Project
      • Part 2: Running Monaca Debugger with Monaca CLI
      • Part 3: Building a Monaca App
      • Part 4: Publishing a Monaca App
    • Electron Tutorial
      • How to Use a NPM Package
      • How to Use a Web API
    • Barcode Scanner Plugin
    • Cordova SQLite Storage Plugin
    • Cordova Google Analytics Plugin
    • Cordova Firebase Plugin
    • Cordova In-app Purchase Plugin
    • Cordova AppVersion Plugin
    • Cordova Ionic Keyboard Plugin
    • Cordova Social Sharing Plugin
    • NIFCLOUD mobile backend
    • Phonegap Push Plugin
  • API Reference
    • Monaca API
      • Monaca Cloud & Remote Build API Guide
      • Utilities
    • Core Cordova Plugins
      • Cordova 11.0
        • Battery Status Plugin
        • Camera Plugin
        • Device Plugin
        • Device Motion Plugin
        • Device Orientation Plugin
        • Dialogs Plugin
        • File Plugin
        • Geolocation Plugin
        • InAppBrowser Plugin
        • Media Plugin
        • Media Capture Plugin
        • Network Information Plugin
        • Splashscreen Plugin
        • Vibration Plugin
        • StatusBar Plugin
      • Cordova 10.0
        • Battery Status Plugin
        • Camera Plugin
        • Device Plugin
        • Device Motion Plugin
        • Device Orientation Plugin
        • Dialogs Plugin
        • File Plugin
        • Geolocation Plugin
        • InAppBrowser Plugin
        • Media Plugin
        • Media Capture Plugin
        • Network Information Plugin
        • Splashscreen Plugin
        • Vibration Plugin
        • StatusBar Plugin
        • Whitelist Plugin (Android Only)
      • Cordova 9.0
        • Battery Status Plugin
        • Camera Plugin
        • Contacts Plugin
        • Device Plugin
        • Device Motion Plugin
        • Device Orientation Plugin
        • Dialogs Plugin
        • File Plugin
        • File Transfer Plugin
        • Geolocation Plugin
        • Globalization Plugin
        • InAppBrowser Plugin
        • Media Plugin
        • Media Capture Plugin
        • Network Information Plugin
        • Splashscreen Plugin
        • Vibration Plugin
        • StatusBar Plugin
        • Whitelist Plugin (Android Only)
    • Third-party Cordova Plugins
      • Advanced HTTP Plugin
      • PhoneGap BarcodeScanner Plugin
      • Cordova Custom Config Plugin
      • DatePicker Plugin
      • Share Plugin (Android)
      • WebIntent Plugin (Android)
    • Monaca Power Plugins
      • Monaca HTML5 Resource Encryption
      • Monaca In-App Updater
      • Monaca Secure Storage
      • Barcode Scanner Plugin
      • Android build memory size setting
    • Service Integration
      • Repro
      • AppsFlyer
    • Configuration Files
      • Android
        • Android Configuration
        • config.xml
        • AndroidManifest.xml
      • iOS
        • iOS Configuration
        • config.xml
        • MonacaApp-Info.plist
  • Samples & Tips
    • Sample Apps
      • AdMob
      • Twitter Single Sign-on App
      • Facebook Single Sign-on App
      • Flickr
      • TODO App
      • BirthYear App
      • Break the Bricks
      • Train Catalog App
      • Omikuji Fortune Telling App
      • Clock App
      • Memo Application
      • RSS Reader App
      • Hello World App
    • Tips & Tricks
      • Playing Sound and Music
      • Control the Splash Screen
      • Using Database
  • Features
    • Push Notification
    • SNS Authentication
    • Database
  • FAQ
    • General
    • IDE
    • Build
    • Release
    • Subscription
      • How to Use Activation Code
    • Application
    • Usage
    • Debugger
  • Supported Environments
  • Trouble Shooting
    • Preview Log repeats to reload (Vue packages version mismatch error)
  • Monaca Product Website
  • 日本語
Powered by GitBook
On this page
  • Setup
  • Connecting a Monaca project to a new GitHub repository
  • Step 1: Creating a new empty repository
  • Step 2: Connecting a Monaca project with the repository
  • Importing a project from a GitHub repository to Monaca
  • Working with a remote repository
  • Checkout from the current working branch
  • Retrieve changes from a remote branch
  • Commit changes to a remote repository
  • Show the remote commit history
  • Show the local commit history
  • Unlink Monaca account from GitHub
  • Unable to relink to GitHub

Was this helpful?

  1. Product Guides
  2. Monaca Cloud IDE
  3. Version Control

GitHub Integration

PreviousIntroductionNextGit SSH Integration

Last updated 3 years ago

Was this helpful?

Generally, you can connect only to public repositories. However, with a valid Monaca subscription plan, you can also connect to private repositories. Please refer to .

Setup

In this section, you will learn how to link a Monaca account to your GitHub account. Please follow the instructions below:

  1. Go to the page.

2. Click the Link button. You are required to login with your GitHub account before being redirected to the GitHub’s Authorize Application page.

3. In the Authorize Application page, you will be asked to authorize the application in order to link your Monaca account to GitHub. Click Authorize application to proceed.

4. Now your Monaca account is linked to your GitHub account.

Please note that you can only link one GitHub account to a Monaca account. If you try to link with multiple accounts, you will encounter an error.

Connecting a Monaca project to a new GitHub repository

Step 1: Creating a new empty repository

Go to your GitHub account and create a new empty repository (without a readme file).

Step 2: Connecting a Monaca project with the repository

At this point you should have linked your Monaca account to GitHub. To connect a Monaca project to the new repository, you will need to do some configurations in the Monaca Cloud IDE:

  1. From the Monaca Dashboard, open the project you want to connect to a repository.

  2. From the Monaca Cloud IDE menu, go to Project → VCS Configure .

  3. Select GitHub.

4. Select your remote empty repository. Then, click Initialize to save the configuration.

The repository cannot be changed after configured.

5. Your project is then uploaded to your new repository in GitHub. By default, your working branch will be configured as master. If you want to switch to another working branch, please go to Project → VCS Configure .

Importing a project from a GitHub repository to Monaca

Once you have linked your Monaca account with GitHub, you can import any existing projects from the GitHub repositories to the Monaca Cloud IDE.

  1. From the dashboard, click Import.

  2. In the Import Project dialog, fill in the necessary information and choose Import from GitHub Repository. Then, select the repository and click the Import button.

3. If the import is successful, the new project will be added to the dashboard. By default, your working branch will be configured as master. If you want to switch to another working branch, please go to Project → VCS Configure.

Working with a remote repository

Once you have successfully connected your project with a repository, you can start working on the same project with your team members and keep it synchronized to the latest updates in the Monaca Cloud IDE.

Monaca Cloud IDE provides a very user-friendly interface supporting the version control of your code. Without learning how to use Git, you can still perform some basic Git commands directly from the IDE.

Checkout from the current working branch

If you have more than one branch and want to change the current working branch, please do as follows:

  1. From the Monaca Cloud IDE menu, go to Project → VCS Configure.

  2. Choose the branch you want to switch to and click the Clear Cache & Save button.

You will get an error message if you try to checkout to a new branch while you have not committed changes on the current working branch yet. Please push your changes to the current branch before checking out to another branch.

Retrieve changes from a remote branch

If you are familiar with Git commands, retrieving changes from a remote branch refers here to the git pull command. To retrieve changes from a remote branch, go to Project → Pull in the Monaca Cloud IDE menu. If there are changes in your remote branch, you will receive those updates in your working branch.

When you create a project in the IDE, Monaca keeps all the files in the www folder. Files outside of this folder are also synced even though they will not appear in the IDE.

Commit changes to a remote repository

After making changes in the current working branch, you are able to commit them back to your remote repository. To commit your changes, please do as follows:

  1. From the Monaca Cloud IDE menu, go to Project → Commit .

  2. Fill in your commit message and check the files you want to commit. Then, click the Commit button.

  3. Once you are ready to push the updates to the remote repository, select Project → Push. After the push, your remote repository will contain the latest changes made in the Monaca Cloud IDE.

Show the remote commit history

In order to see the full history of your previous commits in the remote repository, go to Project → Show Remote History. You will be redirected to the remote Git service provider’s website showing the commit history of your current branch.

Show the local commit history

Every commit you make in your Monaca Cloud IDE is called a local commit. You are able to view your local commit history through Project → Show Commit History. To view the changes of each commit, click the commit on the left panel.

Unlink Monaca account from GitHub

To unlink your Monaca account from GitHub, please do as follows:

  1. Click the Unlink button.

Unable to relink to GitHub

Therefore, to re-link your account, please do as follows:

  1. Logout from the Monaca Cloud IDE.

3. Fill in your GitHub account information.

4. Then, you will be redirected to the GitHub’s Authorize application page. Click Authorize application to proceed.

5. After this, your Monaca account should be linked to your GitHub account. You can confirm this on the Link to GitHub page. It should look like this:

Go to the page.

If you accidentally unlink your Monaca account from Github, relinking it with the steps described in will not work. You will see the following error:

Go to the page and choose Sign in with GitHub.

Link to GitHub
Monaca Login
Setup
Monaca Subscription Plan
Link to GitHub