vue-app

This template should help get you started developing with Vue 3 in Vite.

Uses

• Vue3 + Vite + Playwright
  • Generated via bun create vue@latest vue-app --ts --vue-router --pinia --vitest --playwright --eslint-with-prettier --force.
• Vitest Coverage and Vitest UI
  • Install via bun add -d @vitest/coverage-v8 @vitest/ui.
• Dependency Cruiser
  • Install via bun add -d dependency-cruiser.
  • Create default configuration via bunx depcruise --init.

  ✔ Where do your source files live? … src
  ✔ Do your test files live in a separate folder? … yes
  ✔ Where do your test files live? … e2e
  ✔ Looks like you're using a 'tsconfig.json'. Use that? … yes
  ✔ Full path to your 'tsconfig.json › tsconfig.json
  ✔ Also regard TypeScript dependencies that exist only before compilation? … yes
  
  ✔ Successfully created '.dependency-cruiser.js'
  

  • and modify not-to-test from ^(e2e) to ^(e2e|__tests__).
• TailwindCSS
  • Installed via bun add -d tailwindcss postcss autoprefixer with some other setup documented in Official document for Vite.
  • runs bunx tailwindcss init -p. (generates tailwind.config.js and postcss.config.ts)
  • update tailwind.config.js
  • add @tailwind directives into src/assets/base.css
• GitHub Actions
  • CI (unit test and E2E test with Playwright). see .github/workflows/ci.yml
  • Release build (host built application on GitHub Pages. You need to activate it in repository's settings page). see .github/workflows/release.yml
• GitHub Pages redirects
  • copy built index.html to 404.html for direct access to vue-router's each pages.
• Codesandbox Configurations
  • bun installed container. see ./.codesandbox/Dockerfile
  • Some useful tasks. see ./.codesandbox/tasks.json
    • Setup tasks runs bun install
    • Run At Start task runs bun run dev. You can preview with dev server.
    • Other defined on demand tasks
      • bun run lint
      • bun run format
• Netlify hosting
  • add public/_redirects for direct access to vue-router's each pages.
• PWA
  • for add to home screen.
  • add public/manifest.json and add meta tags into index.html.
• Version up reload script
  • public/vup.js, scripts/v.js and scripts/v.sh implements auto reloading when new version has released for PWA (without reload button).
• Storybook
  • initialized with bunx storybook@latest init.
• Some Tweaks
  • bun's package.json parsing is not same as npm, so I updated the .scripts.build from "run-p type-check \"build-only {@}\" -- " to "run-p type-check 'build-only {@}' --".
    • refs. Spaces and quotes aren't handled correctly by bun run · Issue #53 · oven-sh/bun
  • Now I can run bun run build with parameter in GitHub Actions like bun run build --base=/${GITHUB_REPOSITORY#*/}/.
    • GitHub pages are hosted in subdirectory, so I need to specify the --base parameter
  • If you don't use bun, revert package.json's .scripts.build into "run-p type-check \"build-only {@}\" -- " and your build script will looks like npm run build -- -- --base=/${GITHUB_REPOSITORY#*/}/.
    • -- should be parsed twice at npm run run-p and npm run build-only.

Recommended IDE Setup

VSCode + Volar (and disable Vetur) + TypeScript Vue Plugin (Volar).

Type Support for .vue Imports in TS

TypeScript cannot handle type information for .vue imports by default, so we replace the tsc CLI with vue-tsc for type checking. In editors, we need TypeScript Vue Plugin (Volar) to make the TypeScript language service aware of .vue types.

If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a Take Over Mode that is more performant. You can enable it by the following steps:

1. Disable the built-in TypeScript Extension
   1. Run Extensions: Show Built-in Extensions from VSCode's command palette
   2. Find TypeScript and JavaScript Language Features, right click and select Disable (Workspace)
2. Reload the VSCode window by running Developer: Reload Window from the command palette.

Customize configuration

See Vite Configuration Reference.

Helper scripts for bun container

bun command can be used via docker. shell.sh runs shell with bun installed container.

shell.sh

This script runs bash with bun installed container. Current directory is mounted in /app. Port mapping is below.

host	inside container	purpose
5555	5173	dev server (5173 in host will used by dev.sh)
4173	4173	Playwright reporter

$ ./shell.sh
port mapping is 5555:5173 4173:4173
root@90cbb764e199:/app# #You can use bun here

build.sh

This script runs bun run build.

$ ./build.sh
$ ./scripts/v.sh ; run-p type-check 'build-only -- {@}' --
commit ref:
$ vue-tsc --noEmit -p tsconfig.vitest.json --composite false
$ vite build
vite v4.4.9 building for production...
transforming...
✓ 48 modules transformed.
rendering chunks...
computing gzip size...
dist/assets/logo-277e0e97.svg        0.28 kB │ gzip:  0.20 kB
dist/index.html                      0.42 kB │ gzip:  0.29 kB
dist/assets/AboutView-4d995ba2.css   0.09 kB │ gzip:  0.10 kB
dist/assets/index-c6ff3635.css       8.94 kB │ gzip:  2.59 kB
dist/assets/AboutView-e65f201b.js    0.29 kB │ gzip:  0.24 kB
dist/assets/index-5649da16.js       85.54 kB │ gzip: 33.70 kB
✓ built in 18.74s

dev.sh

This script runs bun run dev. Development server will hosted on the port 5173. Port mapping is below.

host	inside container	purpose
5173	5173	dev server

$ ./dev.sh
port mapping is 5173:5173
$ vite --host

  VITE v4.4.9  ready in 2785 ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: http://172.17.0.2:5173/
  ➜  press h to show help

test.sh

This scripts runs Playwright tests and show reports.

It runs npm run build and npm run test:e2e which runs Playwright tests. Then, it runs npx playwright show-report, so you can see the report in http://localhost:9323/.

Port mapping is below.

host	inside container	purpose
9323	9323	Playwright reporter

$ ./test.sh
port mapping is 9323:9323
test with npm run build && npm run test:e2e
then npx playwright show-report --host 0.0.0.0

> [email protected] build
> ./scripts/v.sh ; run-p type-check 'build-only -- {@}' --

commit ref:

> [email protected] type-check
> vue-tsc --noEmit -p tsconfig.vitest.json --composite false


> [email protected] build-only
> vite build

vite v4.4.9 building for production...
✓ 48 modules transformed.
dist/assets/logo-277e0e97.svg        0.28 kB │ gzip:  0.20 kB
dist/index.html                      0.42 kB │ gzip:  0.29 kB
dist/assets/AboutView-4d995ba2.css   0.09 kB │ gzip:  0.10 kB
dist/assets/index-c6ff3635.css       8.94 kB │ gzip:  2.59 kB
dist/assets/AboutView-e65f201b.js    0.29 kB │ gzip:  0.24 kB
dist/assets/index-5649da16.js       85.54 kB │ gzip: 33.70 kB
✓ built in 27.15s
npm notice
npm notice New major version of npm available! 9.6.7 -> 10.1.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v10.1.0
npm notice Run npm install -g [email protected] to update!
npm notice

> [email protected] test:e2e
> playwright test


Running 3 tests using 2 workers
  3 passed (42.4s)

To open last HTML report run:

  npx playwright show-report

you can see the report in http://localhost:9323/

  Serving HTML report at http://0.0.0.0:9323. Press Ctrl+C to quit.

docker-build.sh

This script builds docker container if not exists. This is internally called from above scripts.

Usage is ./docker-build.sh name-of-built-container path/to/context/folder

This sample runs (cd .codesandbox; docker build -t bun .) if the container image bun:latest does not found.

$ ./docker-build.sh bun .codesandbox
# ... build log

netlify.sh

WIP

Project Setup

bun install

Compile and Hot-Reload for Development

bun run dev

Type-Check, Compile and Minify for Production

bun run build

Run Unit Tests with Vitest

bun run test:unit

Run End-to-End Tests with Playwright

# Install browsers for the first run
bunx playwright install

# When testing on CI, must build the project first
bun run build

# Runs the end-to-end tests
bun run test:e2e
# Runs the tests only on Chromium
bun run test:e2e -- --project=chromium
# Runs the tests of a specific file
bun run test:e2e -- tests/example.spec.ts
# Runs the tests in debug mode
bun run test:e2e -- --debug

Lint with ESLint

bun run lint