How fossamagna/gas-vue-boilerplate works
Project type and purpose
• This is a full-stack boilerplate for building and deploying a single-page web application on Google Apps Script (GAS).
• Frontend: Vue.js + Vuetify + TypeScript, bundled by Webpack.
• Backend: TypeScript code for GAS, bundled by Webpack, deployed via clasp.
• Testing: frontend unit/e2e tests (Jest, Cypress), backend tests via gas-test CLI.
• CI/CD: GitHub Actions with encrypted credentials to push to GAS and run tests.
File structure
• Top level: monorepo managed by Lerna (lerna.json), root package.json (scripts, tool versions), scripts folder (init-repo.js).
• /frontend: Vue CLI project
• src/ Vue components, views, router, store, plugins
• tests/ unit (Jest) and e2e (Cypress)
• config files: Babel, ESLint, TypeScript, Vue, Jest, Cypress
• /backend: GAS project
• src/ server-side TS (e.g., echo.ts, index.ts)
• test/ gas-test tests
• webpack.config.js, tsconfig.json
• clasp config files (.clasp.json, encrypted credentials)
• CI: .github/workflows/nodejs.yml to install deps, decrypt credentials, build, test, deploy.
README for additional insights
• The boilerplate supports local development: yarn scripts to build, test, deploy.
• Deployment flow: Webpack → compile frontend & backend → clasp push to GAS → webapp served.
• gas-test: remote execution of GAS functions for automated testing.
• GitHub Actions: decrypt .clasprc.json.enc and gas-test-credentials.json.enc, then run tests and clasp push.