OpenSourceMapping
A repo for testing open source solutions for my thesis on associated branches. The winner will be on the main branch
How to run the project
npm install to install all the dependencies
npm start to start the project
CI/CD
Tests
/src/tests contains all the tests for the application. These are run using npm test and are run on every push to the repo.
Check for unused dependencies
npm-check to find the unused packages
npm uninstall <package_name> remove the package and module folder
NPM Packaging
npm login to login to npm
npm publish to publish the package to npm but make sure to increment the version number in package.json first
Capacitor
Make sure to remove the home page from the package.json file before building the app. This is because the home page is not a capacitor page and will cause the app to crash.
Firstly make sure you have a fresh build of npm run build and then run npx cap sync to copy the build to the capacitor project. Then run npx cap open android to open the project in Android Studio. You can then run the project from there. Then you can do the same for iOS with npx cap open ios and then run the project from XCode.
Make sure to remove the homepage link inside the package.json because it interferes with the npx suite when developing capacitor apps
What has happened so far
Weeks 1-6
Implemented GeoMoose, OpenLayers and Leaflet for the purpose of being able to upload geojson and stress test each of them until failure. The results are that GeoMoose and Leaflet performed poorly in comparison to openlayers. Choosing OpenLayers as the winner, we can start building the final application.
Weeks 7-13
The aim is to build the main functionality of the application. This includes: The Plan content below which can be summarised as mapping capabilities, offline capabilities and eventually packaging the application for use in FAIMS.
The Plan
- [x] Implement the main UI from figma
- [x] Build the map for the main UI
Implement Steve's features including:
- [x] Buttons to draw geoJson points, lines and polygons
Implement requirements from the thesis:
- [ ] Create, Upload and Delete GeoJSON files
- [x] Implement points
- [x] Implement polygons
- [x] Implement lines
- [ ] Implement symbology (aka colour picker for points, lines and polygons)
Offline Capabilities:
- [ ] Implement local storage for GeoJson
- [ ] Implement local storage for symbology
- [ ] Implement local storage for user input
- [ ] Implement local storage for map tiles offline caching
- [ ] Implement GeoTiff uploading tiles
- [ ] Implement Queries for geojson and symbology
Performance
- [x] Create benchmarks for performance
- [ ] Automate regression tests
- [ ] Maintain benchmarking