# Tech Context — Strava Frontend

## Stack

- **Vue 3** (3.5) + **TypeScript** 5.4 (strict mode, `noEmit`)
- **Vite** 4 (dev server, bundler) with `@vitejs/plugin-vue` and `@intlify/unplugin-vue-i18n/vite`
- **Pinia** 3 — state management (options-style stores; vue ≥3.3 required)
- **vue-router** 4 — history-mode routing
- **vue-i18n** 9 — i18n (composition mode, default/fallback `ru`)
- **Vuestic UI** 1.9 — component library (+ `@vuestic/tailwind`)
- **Tailwind CSS** 3.4 + **PostCSS** + **autoprefixer** — utilities/styling
- **Sass** — global styles
- **Axios** 1.6 — HTTP client
- **Chart.js** 4 + `vue-chartjs` 5 (+ zoom/geo/adapter-moment plugins) — charts
- **vue-yandex-maps** — Yandex Maps integration
- **@vueuse/core**, **vue-moment**, **flag-icons**, **ionicons**, **medium-editor**, **epic-spinners**, `register-service-worker` (PWA), `@gtm-support/vue-gtm` (analytics)
- **Storybook** 7 — component dev environment

## Tooling

- **ESLint** 9 flat config (`eslint.config.mjs`) with `vue`, `typescript-eslint`, `prettier` plugins
- **Prettier** 3 — formatting
- **Husky** + **lint-staged** — pre-commit lint of `src/**/*.{ts,js,vue}`
- **vue-tsc** — type checking at build

## Scripts (`package.json`)

- `yarn dev` — Vite dev server
- `yarn build` — `vue-tsc --noEmit && vite build`
- `yarn lint` — eslint --fix over src
- `yarn format` — prettier --write
- `yarn storybook` / `yarn build-storybook`
- `yarn build:ci` / `yarn start:ci` — CI build + static serve

## Environment

- API host is a hardcoded constant `HOST` in `src/main.ts` (no `.env`-driven base URL). Yandex Maps API key and GTM keys are hardcoded / env-driven (`VITE_APP_GTM_ENABLED`, `VITE_APP_GTM_KEY`).
- Locales: `br, cn, es, gb, ir, ru` (default `ru`).
- Deploy: Dockerfile + `nginx.conf`; `run.sh` local runner.

## Constraints

- No test framework configured (no vitest/jest/cypress). Verification = `yarn lint` + `yarn build`.
- Backend API contract: `/api/v0/*`, JWT Bearer auth, error envelope may be `{ code, message, detail }` (see backend `app/web/errors.py`).
- Keep `vue-tsc` clean — build fails on type errors.