Web site to host air quality warnings, built using Quarto and deployed on GitHub Pages.
The following technologies are used:
Here is high-level documentation on the development of applications and the use of GitHub in the Government of BC:
Instructions are geared toward the following tools:
- Ensure R, RStudio, and Quarto are installed on the machine
- Clone this repository using GitHub Desktop
- Open project in RStudio
- Make and required changes
- Render the site locally to review
Run
quarto renderin the Terminal or select "Render" from RStudio's Source Pane
Note: we rely on pre-render scripts to generate the front page and process the logo header section of the site, these may not render as expected locally and are better tested via the PR Preview Action that runs on all PRs in this repo.
To deploy to PROD and to TEST you require a GitHub Account, membership in the bcgov organization, and write access to this repository.
Open a PR in this repo and a PR Preview GitHub Action will automatically run.
Workflow: .github/workflows/pr.yml
Any PR that is merged into main is automatically deployed to gh-pages which is the 'production' or live version of the website.
Workflow: .github/workflows/merge.yml
Follow the steps outlined in this repository to contribute: CONTRIBUTING.md.
Copyright 2025 Province of British Columbia.
Code is 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 http://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.
Air quality warnings and website documentation by the Province of British Columbia is licensed under a Creative Commons Attribution 4.0 International License: https://creativecommons.org/licenses/by/4.0/.
Some trademarks/logos found in this repository are the intellectual property rights of our partner organizations and are included here with permission solely for BC government use in association with the official public air quality warnings. These trademarks/logos remain the intellectual property rights of the respective partner organizations:
- First Nations Health Authority Logo is copyright (c) First Nations Health Authority
- Interior Health Authority Logo is copyright (c) Interior Health Authority
- Fraser Health Authority Logo is copyright (c) Fraser Health Authority
- Vancouver Coastal Health Authority Logo is copyright (c) Vancouver Coastal Health Authority
- Vancouver Island Health Authority Logo is copyright (c) Vancouver Island Health Authority Logo
- Northern Health Authority Logo is copyright (c) Northern Health Authority
- BC Centre for Disease Control is copyright (c) Provincial Health Services Authority
- WorkSafeBC Logo is copyright (c) WorkSafeBC