assets added

Author: mrdavidorok

docs/troubleshooting/ github-issues/fix_github_push_error_repository_not_initialized.md

@@ -0,0 +1,47 @@
+---
+keywords: ['github', 'push', 'repository', 'initialize', 'error']
+slug: /fix-github-push-error-repository-not-initialized
+title: Fix GitHub Push Error by Initializing the Repository
+---
+# Fix GitHub Push Error by Initializing the Repository
+
+# Fix GitHub Push Error by Initializing the Repository
+
+When pushing code to GitHub, you may encounter the following error:
+
+```
+Error pushing repository. Make sure your repository is initialized
+```
+
+This issue often occurs when your GitHub repository was not initialized correctly or if your project exceeds GitHub’s file size limits.
+
+
+**Reinitialize Your GitHub Repository**
+
+Follow these steps to properly initialize your repository:
+
+    1. Go to **[GitHub](https://github.com/)** and create a new repository.
+    2. Check the box for **Add a README file** during creation.
+    3. After creation, follow the standard steps to connect your GitHub repository to FlutterFlow.
+
+    ![](../assets/20250430121522561282.gif)
+
+:::warning[Check Your Asset Size]
+GitHub does not allow individual files larger than **25MB**. Large image or video files may cause push failures.
+:::
+
+**Check for GitHub Size Limits**
+To review your file sizes:
+
+    1. Download your project code.
+    2. Open the `assets` folder.
+    3. Identify files larger than 25MB.
+
+
+:::tip[Recommended Fix]
+To reduce project size:
+- Use **network assets** instead of uploading large files directly.
+- Optimize images before uploading.
+:::
+
+By ensuring your repository is initialized and staying within GitHub’s file size limits, you can avoid this push error.

docs/troubleshooting/ github-issues/resolve_github_repository_head_deployment_error.md

@@ -0,0 +1,53 @@
+---
+keywords: ['deployment', 'github', 'repository', 'codemagic']
+slug: /resolve-github-repository-head-deployment-error
+title: Resolve Repository Head Deployment Error on GitHub
+---
+# Resolve Repository Head Deployment Error on GitHub
+
+When deploying your FlutterFlow app to the Apple App Store or Google Play via GitHub, you may encounter the message `Failed to set the repository head`. This typically means there's an issue with access permissions, a missing branch, or network configuration.
+
+This article outlines the possible causes and step-by-step instructions to fix this issue.
+
+:::warning[Deployment Error]
+You may encounter the following error in your build log:
+```
+Failed to set the repository head
+```
+:::
+
+Here are the possible causes of this error:
+
+   - The GitHub repository does not exist or was deleted.
+   - You do not have permission to access or write to the repository or the branch.
+   - The branch specified in the build settings does not exist.
+   - Network or API connectivity issues between GitHub and the deployment service.
+   - The codebase contains build or structural errors that prevent deployment.
+
+
+Use the steps below to resolve the error:
+
+1. **Verify Repository Name**
+   - Ensure the repository name in your FlutterFlow deployment settings matches the name in GitHub exactly.
+
+2. **Check Branch Name**
+   - Make sure the branch you are deploying from exists in the repository.
+   - Avoid typos and capitalization mismatches.
+
+3. **Review Access Permissions**
+   - Confirm you have push/write access to the repository and the specific branch.
+   - If using a service account or GitHub App, ensure it has appropriate scopes.
+
+4. **Check Network Connectivity**
+   - Ensure there are no firewall, VPN, or DNS settings interfering with GitHub access.
+
+5. **Validate Code Locally**
+   - Before deploying, ensure your project builds and runs successfully on your local machine.
+
+
+:::info[Additional Resources]
+- Learn more about **[setting up GitHub Deployment](/integrations/github/github-deployment-overview)**.
+- Refer to **[Codemagic Error Identification Guide](/testing/codemagic-identify-errors)** to classify other deployment failures.
+:::
+
+By following these steps, you can resolve the repository head error and continue your GitHub deployment without interruptions.