/test_github_page

Test demonstrating how to publish a Vue/Quasar PWA app to GitHub Pages using GitHub actions.

Primary LanguageJavaScriptMIT LicenseMIT

Test Quasar/Vue app deployment to GitHub Page via GitHub actions

This projects test the build + deploy of a Quasar application via GitHub Actions to this project GitHub Page.

GitHub actions are "scripts" automatically executed by GitHub when you push (or create an issue...). GitHub Pages is a feature provided by GitHub that allows publishing a given project branch as a static web-site.

Actions are grouped in sequence in a "workflow". The workflow deploying this application to GitHub is found in .github/workflows/release-to-gh_page-branch.yml. Uses GitHub online editor to edit action workflow as it provides smart completion and browsing/searching the library of available actions.

The log of the workflow execution can be found on the Actions tab.

The action workflow copy the quasar build results found in dist/pwa to the gh_pages branch.

Configuring GitHub Page in project Settings > Pages:

  • Show the URL of the project GitHub page.
  • Set source as branch gh_pages
    • either create the branch manually
    • or change this settings after push a first time (causing the action workflow to create the branch)
  • Added the action workflow to the project github/workflows directory. See file: .github/workflows/release-to-gh_page-branch.yml

Related documentations

Quasar

Install the dependencies

yarn
# or
npm install

Start the app in development mode (hot-code reloading, error reporting, etc.)

quasar dev -m pwa

Lint the files

yarn lint
# or
npm run lint

Build the app for production

quasar build -m pwa

Customize the configuration

See Configuring quasar.config.js.