# frontend-large

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

## Recommended IDE Setup

[VS Code](https://code.visualstudio.com/) + [Vue (Official)](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur).

## Recommended Browser Setup

- Chromium-based browsers (Chrome, Edge, Brave, etc.):
  - [Vue.js devtools](https://chromewebstore.google.com/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd)
  - [Turn on Custom Object Formatter in Chrome DevTools](http://bit.ly/object-formatters)
- Firefox:
  - [Vue.js devtools](https://addons.mozilla.org/en-US/firefox/addon/vue-js-devtools/)
  - [Turn on Custom Object Formatter in Firefox DevTools](https://fxdx.dev/firefox-devtools-custom-object-formatters/)

## 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 [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) to make the TypeScript language service aware of `.vue` types.

## Customize configuration

See [Vite Configuration Reference](https://vite.dev/config/).

## Project Setup

```sh
npm install
```

### Compile and Hot-Reload for Development

```sh
npm run dev
```

### Type-Check, Compile and Minify for Production

```sh
npm run build
```

### Build With OSS or Local Assets

```sh
# Use VITE_ASSET_BASE_URL from .env.production
npm run build:oss

# Bundle with local assets and ignore the OSS URL
npm run build:local
```

## Image Assets

Put local development images in `src/assets/images`.

Use the helper below in Vue files:

```ts
import { assetUrl, cssAssetUrl } from '@/commons/assets'

const qrcode = assetUrl('game1/qrcode.png')
const bg = cssAssetUrl('game1/bg.png')
```

Default behavior:

- development: prefer local files from `src/assets/images`
- production: use `VITE_ASSET_BASE_URL` when configured, otherwise use `/assets/images/...`

For OSS/CDN production builds, create `.env.production`:

```env
VITE_ASSET_BASE_URL=https://your-bucket.oss-cn-shanghai.aliyuncs.com
```

If you need to test OSS during development:

```env
VITE_ASSET_DEV_LOCAL=false
VITE_ASSET_BASE_URL=https://your-bucket.oss-cn-shanghai.aliyuncs.com
```

Production image resources should be uploaded to OSS/CDN, or served from `/assets/images/...` if no OSS base URL is configured.
