Invasive species are non-native plants and animals whose introduction and spread in British Columbia cause significant economic, social or environmental damage. This application tracks the observation, treatment, and monitoring of invasive species in the Province of British Columbia.

This project is part of the Species and Ecosystems Information System Modernization (SEISM) program.

1. Project Status
2. Audience
3. Features
4. Getting Help or Reporting an Issue
5. How to Contribute
6. Architecture
7. Project Structure
8. Documentation
9. Requirements
10. Setup Instructions
11. Running the Application
12. License

This application is in active development and has not yet been released.

Anyone with a valid IDIR or BCeID login may access the application to view data that is being tracked.

In addition, the application is intended for use by:

• Surveyors who observe and record the absence, presence, and spread of invasive species
• Subject matter experts who perform a variety of duties, including to record and analyze data and create action plans
• Contractors who implement recommended treatments for observed invasive species
• Administrators who manage the application and its users

This application is anticipated to include the following main features:

1. Support for IDIR and BCeID access
2. User roles and permissions management
3. Interactive maps displaying multiple data layers
4. Observations of invasive species absence/presence
5. Recommendations, planning, and application records of treatments
6. Monitoring of treatment outcomes
7. Query and export of data
8. Auditing and reports
9. Bulk data entry and mobile device data entry

To report bugs/issues/features requests, please file an issue.

If you would like to contribute, please see our contributing guidelines.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

This application uses PostgreSQL (with PostGIS), Ionic/React (for Web, IOS and Android). Our environments run on an OpenShift container platform cluster.

.config/                   - Common application configuration
.github/                   - Github actions
.docker/                   - Common Dockerfiles
.vscode/                   - IDE config for Visual Studio Code
api/                       - API codebase
app/                       - Capacitor APP Codebase
sharedapi/                 - Files shared between App and API (enums, RJSF Schemas, etc)
database/                  - Database Codebase
env_config/                - ENV config files
testing/                   - Test scripts, in particular Postman configs
CODE-OF-CONDUCT.md         - Code of Conduct
CONTRIBUTING.md            - Contributing Guidelines
LICENSE                    - License

For additional Documentation about the InvasivesBC Application, see the Wiki

• XCode* (for iOS builds only)
• Android Studio* (for Android Builds only)
• Node >=20.0 or Docker

The ideal multi-platform supporting machine is the Mac, But Windows and Linux work for Web and Android development.

Install AndroidStudio and the Android SDK.

On MacOS: Install xCode.

Clone the repository to your own machine and follow instructions below.

In the app directory:

1. npm ci
2. npm start

In the api directory:

1. npm ci
2. npm run dev

In the root directory

1. make docker

On MacOS, Windows or Linux, in the app directory:

1. npm install
2. npm run build:android
3. cd ..
4. make run-android

Android Studio will open and, after a short delay, will allow you to run the application in the simulator or a connected device.

On MacOS, in the app directory:

1. npm install
2. npm run build:ios
3. cd ..
4. make run-ios

Xcode will open and, after a short delay, will allow you to run the application in the simulator or a connected device.

Copyright 2019 Province of British Columbia
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.