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
+14-23Lines changed: 14 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -289,22 +289,20 @@ When performing a Git merge in FlutterFlow, you’ll see a screen with multiple
289
289
290
290
-**Branch Information**: At the top of the merge interface, you’ll see exactly which branches are being merged. You have two options for merging directions:
291
291
-**Parent → Child**: Pulls changes down from the parent into the child branch, often used to keep a feature branch in sync with the parent branch.
292
-
-**Child → Parent**: Pushes features (or other changes) from the child branch back up to the parent, commonly done once a feature is ready to go into parent branch.
293
-
-**YAML Validation Errors**: Occurs when manual edits to the YAML files produce invalid syntax. Clicking on these errors should redirect you to the specific file. Invalid lines will be underlined in red within the file and, you **cannot** complete the merge while YAML errors exist.
292
+
-**Child → Parent**: Pushes features (or other changes) from the child branch back up to the parent, commonly done once a feature is ready to go into the parent branch.
293
+
-**YAML Validation Errors**: Occurs when manual edits to the project files produce invalid syntax. Clicking on these errors should redirect you to the specific file. Invalid lines will be underlined in red within the file, and, you **cannot** complete the merge while YAML errors exist.
294
294
-**Project Errors**: Project errors occur when the result of a merge creates a problem in your project. For example, this might happen if the merge results in two data types having the same name. These errors need to be resolved to ensure your project works as expected. You have several options to deal with project errors:
295
295
-**Fix Errors During the Merge**: This approach ensures that the merged project is error-free right from the start. Here’s how you can do it:
296
-
- **Edit the YAML files:** Update the YAML files to fix issues, such as renaming a data type that causes a conflict.
296
+
- **Edit the YAML files:** Update the project YAML files (in the Right Lower Panel) to fix issues, such as renaming a data type that causes a conflict.
297
297
- **Edit the Project Directly while Merging:** While still in the merge process, open the project, make the necessary changes (like renaming the conflicting data type), and then continue.
298
298
-**Fix Errors After the Merge**: If you prefer, you can complete the merge first and address the errors later. For example, finish the merge process as it is. After merging, go back to the project and resolve any issues.
299
299
-**Cancel**: Abandons the merge process and discards any conflict resolutions you’ve already applied during this merge session.
300
300
-**Merge**: Finalizes the merge once all merge conflicts and YAML validation errors are cleared. Project errors can remain if you choose to resolve them later.
301
-
-**Bulk Accept Changes**: Accessible via the **arrow** next to **Merge** button. this option lets you accept all changes from one branch at once—handy if you already know which branch’s changes take precedence.
301
+
-**Bulk Accept Changes**: Accessible via the **arrow** next to **Merge** button. This option lets you accept all changes from one branch at once—handy if you already know which branch’s changes take precedence.
302
302
303
303
**Left Panel**
304
304
305
-
The left-hand side panel displays all the project configuration YAML files, which are crucial for managing your project’s settings and structure.
306
-
307
-
YAML (Yet Another Markup Language) files use a simple, human-readable format to define configuration data. They are particularly useful during a merge because they allow you to directly review, understand, and resolve any changes or conflicts in your project’s configuration.
305
+
The left-hand side panel displays all the project files in YAML format. YAML (Yet Another Markup Language) files use a simple, human-readable format to define configuration data. They are particularly useful during a merge because they allow you to directly review, understand, and resolve any changes or conflicts in your project’s file.
308
306
309
307
-**Filter Files:** You can use filters to narrow down the list of YAML files based on specific criteria:
310
308
@@ -317,7 +315,7 @@ YAML (Yet Another Markup Language) files use a simple, human-readable format to
317
315
- A **conflict** occurs when the same part of a file has been changed in both branches, making it unclear which version to keep. For instance, if one branch changes the color of the Container to blue and the other changes it to red, this creates a conflict.
318
316
:::
319
317
320
-
-**Search File:** If you’re looking for a particular file, you can use the search bar to locate it quickly. This is especially useful in larger projects with many configuration files.
318
+
-**Search File:** If you’re looking for a particular file, you can use the search bar to locate it quickly. This is especially useful in larger projects with many files.
321
319
322
320
Clicking on a file in the panel opens it in the editor, allowing you to view, edit, and resolve issues directly.
323
321
@@ -326,39 +324,32 @@ Clicking on a file in the panel opens it in the editor, allowing you to view, ed
326
324
The Upper Right Panel offers a quick, side-by-side comparison of file changes from both branches, along with easy one-click accept buttons and previews. This panel makes it simple to decide which changes to keep or discard.
327
325
328
326
:::info
329
-
We highlight edits using green and red (Git) color coding:
327
+
The edits are highlighted using green and red (Git) color coding:
330
328
331
329
-**Green** indicates lines or values **added** (or unique) in one branch.
332
330
-**Red** indicates lines or values **removed** (or replaced) by that branch.
333
331
:::
334
332
335
333
-**Accept Change Button**: Quickly accept changes from one branch if you know it has the correct edits.
336
-
-**Eye (Preview) Icon**: Open or view the file in the FlutterFlow builder to see how the changes look. For example, you can preview a theme color change visually rather than just reading its name in YAML.
334
+
-**Eye (Preview) Icon**: Open or view the file in the FlutterFlow builder to see how the changes look. For example, you can preview a theme color change visually rather than just reading its name in the file.
337
335
338
336
**Right Lower Panel**
339
337
340
338
The **Lower Panel** displays the final merged files after Git applies its merging logic. It gives you a chance to manually inspect and edit the outcome—whether or not a conflict occurs.
341
339
342
-
Git attempts to combine changes from both branches automatically. If Git can’t reconcile certain lines, it flags a **merge conflict** in the file. Conflicts appear with special markers like `<<<<<<< HEAD`, `=======`, and `>>>>>>>`.
340
+
Git attempts to combine changes from both branches automatically. If Git can’t reconcile certain lines, it flags a **merge conflict** in the file. Conflicts appear with special markers like `<<<<<<<`, `=======`, and `>>>>>>>`.
343
341
344
-
-`<<<<<<< HEAD`: Marks the beginning of your current branch’s changes.
342
+
-`<<<<<<<`: Marks the beginning of other branch’s changes
345
343
-`=======`: Separates your current branch’s changes from the other branch’s changes.
346
-
-`>>>>>>> <other-branch>`: Marks the end of the conflict, indicating the other branch’s changes.
347
-
348
-
You might decide to keep certain lines from `HEAD` (your current branch) or from the other branch or combine them manually.
349
-
350
-
:::info
351
-
352
-
During merge conflict, Git may label branches as `HEAD` or a commit reference, which can differ from the friendly branch names you given.
353
-
354
-
-**HEAD**: Refers to the current branch (or commit) you’re on—essentially your “main viewpoint” in Git.
355
-
-**Other Branch**: Denotes the second branch (or commit) you’re merging in, which might be labeled using a commit hash.
344
+
-`>>>>>>>`: Marks the end of the conflict, indicating your current branch’s changes.
356
345
346
+
:::tip
347
+
You might decide to keep certain lines from `<<<<<<<` (from the other branch) or `>>>>>>>` (from your branch) or combine them manually.
357
348
:::
358
349
359
350
You can modify files or edit the project directly from the lower panel at any time—even if there’s no conflict.
360
351
361
-
After editing, click **Save Changes** to confirm your changes. A red reset button appears if you want to undo your edits and restore the file to its initial state before you began editing.
352
+
After editing, click **Save Changes** to confirm your changes. A red reset button appears if you want to undo your changes and restore the file to its initial state before you began editing.
362
353
363
354
### Resolve Merge Conflicts
364
355
A merge conflict occurs when multiple team members make changes to the same part of the project.
0 commit comments