Working with Git Repository

Working with branches

GitHub is integrated with Flatlogic hosting, enabling seamless deployments directly from the platform. There are two branches available: master and ai-dev.

  • The master branch is designed for you to make direct changes to the source code.
  • The ai-dev branch is managed by the Flatlogic system, which handles updates to the generated code automatically.

For Free Templates: If you're using a free (community) template, you can connect GitHub and push your code without additional costs.

For Paid Templates: If you're using a paid (advanced) template, pushing to GitHub will require a one-time fee of credits. When you click "Push to GitHub", you'll see a confirmation dialog showing the credit cost to activate this feature for your project.

To trigger a Flatlogic Bot commit, simply click the Push to GitHub button after making changes to your app. Once the changes are pushed, you’ll need to create a pull request and merge the ai-dev branch into master.

For optimal workflow, avoid making manual changes to the ai-dev branch and leave it exclusively for the Flatlogic system's updates.

Here is a video example of How to push platform updates to Github and merge branches.

Development and Stable Environments

When working with Git integration, it's important to understand how it relates to the Development and Stable environments:

  • Changes made in the Development environment can be pushed to GitHub
  • When you sync changes from Development to Stable, these changes aren't automatically pushed to GitHub
  • To keep your GitHub repository in sync with your Stable environment, make sure to push changes after important deployments

Master Branch

All customizations should be made in the master branch on GitHub.

To apply your changes and see them in your application, go to your Project Settings on Flatlogic.com. Click Deploy from Git, and your application will be rebuilt to include the updates from GitHub. Also you can click to the "Sync to Stable Environment" button while you working with your app into the Editing Mode. This deployment will consume credits according to your plan.

Ai-dev Branch

After any changes you have made to your project using AI Engineer, you should hit Save button and Flatlogic system will push changes to the ai-dev branch automatically. More information you will find in the Editor article.

Version Control Integration

The automatic version control system in Flatlogic integrates with GitHub in the following ways:

  • Each significant checkpoint created in the Development environment will be pushed to automatically
  • You can roll back to previous versions in the Development environment
  • You can push any of your desirable version from Development environment to the Stable and synchronize it with your own GitHub repository
  • This gives you multiple layers of version control – both within Flatlogic and through GitHub

If you face any difficulties, please message us on our Discord, Forum, Twitter, or Facebook. We will respond to your inquiry as quickly as possible!

← Working with GitHub                                                          Deploying Your App →