strava-frontend/.roo/memory-bank/techContext.md

Tech Context — Strava Frontend

Stack

• Vue 3 (3.5) + TypeScript 5.8 (strict mode, noEmit)
• Vite 5 (dev server, bundler) with @vitejs/plugin-vue 5 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

Tooling

• ESLint 9 flat config (eslint.config.mjs) with vue, typescript-eslint 8, prettier plugins
• Prettier 3 — formatting
• Husky + lint-staged — pre-commit lint of src/**/*.{ts,js,vue}
• vue-tsc 2 — 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 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 (node:22, yarn install --frozen-lockfile) + nginx.conf; run.sh local runner.
• Dev environment requires Node ≥18.19 (vite 5); Docker uses node:22 (eslint 9 transitives need ≥20).

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.