MerginMaps / MerginMaps/mobile
Mobile cannot synchronize after resolving multiple project files on server (project had multiple .qgs/.qgz)
Nobody has claimed this yet.
- Dominant language
- C++
- Stars
- 388
- Forks
- 87
- Avg merge
- 2d 7h
- Merged PRs (30d)
- 20
Description
Description
When a project initially contains multiple project files (.qgs/.qgz), it cannot be opened on mobile (expected). After deleting one of the project files in Mergin Maps Web so that exactly one project file remains, the project should synchronize on mobile and become openable. Instead, synchronization fails on iOS, Android, and Windows app version 2025.7.0.
Environment
Staging
Application (+ app version, build, operating system)
- Mergin Maps iOS app: 2025.7.0
- iOS version: iOS 26.0
- Mergin Maps Android app: 2025.7.0
- Android: 15
- Mergin Maps Windows app: 2025.7.0
- Windows: Windows 11
Steps to reproduce
- Prepare a project that contains more than one project file (e.g., project.qgz and project_alt.qgz).
- Download this project to the Mergin Maps mobile app (iOS, Android, or Windows).
- Opening the project is blocked with a “multiple project files” message (expected).
- In Mergin Maps Web, delete one of the project files so the project has exactly one .qgs or .qgz file remaining.
- In the mobile app, attempt to synchronize (pull the latest from server).
Actual results
- Synchronization does not proceed. The project remains in a non-openable/invalid state on the device even though the server project now contains a single project file.
- If any error banner/dialog appears, the sync is still unsuccessful. In some runs there may be no actionable prompt to complete the sync.
- Workaround: If the local project is removed from the device and then downloaded again after removing the additional project file on Mergin Maps Web, the project can be opened.
Expected results
- After the extra project file is removed on the server, the mobile app should synchronize successfully.
- The project should become openable on mobile, and any “multiple project files” warning should clear automatically after a successful sync.
- If other pending updates exist, they should be visible and not obscured by any outdated warning banners.
Screenshots or logs
Conclusion
Created by GitHub Copilot and supervised by a human test analyst.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the synchronization flow on iOS, Android, or Windows after deleting the extra .qgs/.qgz file from the server. Trace how the mobile app handles the existing multiple-project-files state during pull; done means synchronization succeeds, the warning clears, and the project becomes openable without requiring a fresh download.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- android, cpp, ios
- Domain
- mobile-dev
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100