You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/testing-deployment-publishing/branching-collaboration/branching.md
+5-133Lines changed: 5 additions & 133 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -188,75 +188,20 @@ During a merge, FlutterFlow compares the changes made in both branches, if the c
188
188
189
189
:::
190
190
191
-
### Initiating a Merge
192
-
193
-
FlutterFlow currently supports **two merging approaches**: the existing “**Merge**” functionality and the new “**Git Merge**” (v2).
194
-
195
-
-[**Merge (Legacy)**](#merge-legacy): The legacy merge uses a custom tool (originally built in FlutterFlow) to calculate differences and conflicts between branches.
196
-
-[**Git Merge (New)**](#git-merge-new): The new Git Merge option leverages Git's robust repository and conflict-resolution capabilities.
197
-
198
-
:::warning
199
-
200
-
At present, both methods are available side by side, allowing you to either continue using the legacy merge or adopt Git Merge. Over time, as Git Merge proves its stability, the Legacy Merge option may be deprecated.
201
-
202
-
The Merge (Legacy) option has some known issues with merges being incorrectly calculated. Therefore, we **strongly recommend using [Git Merge](#git-merge-new)** whenever possible for a smoother and more accurate merge process.
203
-
204
-
:::
205
-
206
-
#### Merge (Legacy)
207
-
208
-
You can initiate a merge in either direction—merging from a parent branch into a child branch or from a child branch back into the parent branch—by selecting the **Branch** Options button next to the current branch in the Branching Menu.
209
-
210
-
<div style={{
211
-
position: 'relative',
212
-
paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
Next, you'll see a screen that will display if there are any conflicts. If you don’t have any conflicts, you can simply go ahead and click **Merge Branch**.
239
-
240
-

241
-
242
-
#### Git Merge (New)
243
-
244
-
The new Git Merge option uses Git under the hood to calculate differences between project files. Each project is backed by a repository of YAML files (except for custom code, which appears as Dart files). These YAML files map directly to various project properties, and Git calculates differences among these files to identify merge conflicts. This method provides clearer and more consistent conflict detection compared to [Merge (legacy)](#merge-legacy) (a custom solution).
191
+
Merging in FlutterFlow uses Git under the hood to calculate differences between project files. Each project is backed by a repository of YAML files (except for custom code, which appears as Dart files). These YAML files map directly to various project properties, and Git calculates differences among these files to identify merge conflicts.
245
192
246
193
:::info[Future Plans]
247
-
248
-
This option is currently in **Beta**. In addition to fixing any issues, here’s what we have planned:
249
-
250
194
-**Hover-Based Documentation**: Display helpful tooltips for YAML fields (scheduled before production release).
251
195
-**Inline YAML Errors**: Show errors directly in the file for quicker fixes (scheduled before production release).
252
196
-**Simplified YAML**: Make YAML files and errors more user-friendly and understandable.
253
197
-**Enhanced Visual Diff Tools**: Provide more intuitive views for comparing changes.
254
198
-**User Experience Improvements**: Continuously refine merging workflows and UI elements.
255
199
-**Performance Optimizations**: Improve speed when initiating merges.
256
-
257
200
:::
258
201
259
-
To initiate a Git Merge, navigate to **Toolbar >** select **Branching > Branching options >** select **Git Merge**.
202
+
### Initiating a Merge
203
+
204
+
To initiate the Merge, navigate to **Toolbar >** select **Branching > Branching options >** select **Merge**.
260
205
261
206
<div style={{
262
207
position: 'relative',
@@ -285,7 +230,7 @@ To initiate a Git Merge, navigate to **Toolbar >** select **Branching > Branchin
285
230
<p></p>
286
231
287
232
288
-
When performing a Git merge in FlutterFlow, you’ll see a screen with multiple panels and info sections. Here are the details of it.
233
+
When performing a merge in FlutterFlow, you’ll see a screen with multiple panels and info sections. Here are the details of it.
289
234
290
235

291
236
@@ -430,79 +375,6 @@ For example, imagine two developers, Alice and Bob, are working on the same Flut
430
375
431
376
When Alice's changes are merged into the main project first, her updates will be integrated without any issues. However, when Bob tries to merge his changes afterward, a merge conflict will occur because the changes to the button text and color have already been modified by Alice.
432
377
433
-
In your project, if you get merge conflicts, here’s how you resolve them.
434
-
435
-
#### Merge (Legacy)
436
-
437
-
<div style={{
438
-
position: 'relative',
439
-
paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
For certain conflicts, such as those involving variables and API configurations, you'll see a **View Configuration** option. Enabling this option opens the split screen view displaying changes from the new branch, allowing you to easily identify what has changed. In this view, you can see things that were removed highlighted in red, and things that were added highlighted in green.
If you choose to resolve manually, you can directly make changes in the **Accepted Changes** section. Note that if you cancel a manual resolution, you can choose to either keep or discard the changes you have made since starting the manual resolution.
470
-
471
-
<div style={{
472
-
position: 'relative',
473
-
paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
If the visual editor doesn't display something in the split screen UI that you need to manage during a merge, click the **Edit Project** button and edit the project as usual.
501
-
502
-
::::
503
-
504
-
505
-
#### Git Merge (New)
506
378
When you initiate a merge using Git, the system attempts to automatically reconcile your project files. Any conflicts that cannot be automatically resolved are flagged for your attention.
507
379
508
380
You can review each file with merge conflicts and choose to:
0 commit comments