Ground is an open source, map-centric data collection platform for occasionally connected devices.
This is not an officially supported Google product, and it is currently under development on best-effort basis. Please check back periodically for updates.
You can learn more about Ground on the project website.
About this Repository
This repo contains all Ground cloud-based / hosted components:
|docs/||Public documentation, including Ground homepage|
|firestore/||Firestore Config defining Firebase rules and other database settings|
|functions/||Firebase Cloud Functions, used to sync with Google Sheets and import/export data to/from other data sources|
|web/||Ground Web Console used to set up and manage projects, and to view, edit, and analyze collected data online|
Firestore Cloud Functions currently only supports Node.js v6.11.5, while the web dashboard is built using a newer version of Node.js. Contributors should use the appropriate version of Node for the component they are working on. Follow the instructions provided in the README of each subdirectory to set up the proper development environment for each component.
❗️We cannot accept contributions from contributors that have not signed the appropriate CLA, so please be sure to sign one before submitting your hard work!
After you have read and understood the contribution guidelines, read the following sections to learn how to fork this repository and contribute.
The following instructions describe how to fork this repository in order to contribute to the ground-platform codebase.
Fork this repository, see https://help.github.com/articles/fork-a-repo/.
Clone your fork:
git clone https://github.com/<username>/ground-platform.git
<username>is your github username.
Add the base repository as a remote:
git remote add upstream https://github.com/google/ground-platform.git
Follow the instructions in the README files of each of the directories listed under About this Repository section of this readme to set up your development environment.
After you have forked and cloned the repository, use the following steps to make and manage changes. After you have finished making changes, you can submit them to the base repository using a pull request.
Pull changes from the base repository's master branch:
git pull upstream master
Create a new branch to track your changes:
git checkout -b <branch>
<branch>is a meaningful name for the branch you'll use to track changes.
Make and test changes locally.
Add your changes to the staging area:
git add <files>
<files>are the files you changed.
git add .to add all currently modified files to the staging area.
Commit your changes:
git commit -m <message>
<message>is a meaningful, short message describing the purpose of your changes.
Pull changes from the base repository's master branch, resolve conflicts if necessary:
git pull upstream master
Push your changes to your github account:
git push -u origin <branch>
<branch>is the branch name you used in step 2.
Create a pull request to have your changes reviewed and merged into the base repository. Reference the issue your changes resolve in either the commit message for your changes or in your pull request.
For more information on creating pull requests, see https://help.github.com/articles/creating-a-pull-request/.
To learn more about referencing issues in your pull request or commit messages, see https://help.github.com/articles/closing-issues-using-keywords/.