TarkovTracker

TarkovTracker tracks Escape from Tarkov tasks, hideout upgrades, required items, levels, and team progress separately for PvP and PvE.

Try it live at https://tarkovtracker.org.

---

Using TarkovTracker

You can start tracking your progress immediately — no account required. Your progress is saved in your browser's local storage and stays there between visits.

What works without an account

• Track task and objective completion (PvP and PvE separately)
• Track hideout module upgrades and the parts you still need
• View player level, faction progress, and needed items
• Browse interactive maps with spawn points and objectives
• Customize display preferences and game mode
• All data persists locally in your browser

What an account enables

Sign in (via Discord, Twitch, Google, or GitHub) when you want to:

• Sync progress across devices — your progress follows you to any browser
• Create or join a team — share progress with teammates in real time
• Share your profile — let others view your progress via a shareable link
• Use API tokens — programmatically read your progress via the public API
• Back up your data — server-side storage protects against browser data loss

[!NOTE] What happens to local progress when you sign in:

• New account: your local progress is uploaded on first login.
• Same browser, same account: local and cloud progress are merged.
• Existing account on a new browser: cloud progress wins; local guest progress is not merged.

Getting help

• Questions or bugs? See SUPPORT.md for where to ask.
• Found a security issue? See SECURITY.md for how to report it privately.
• Community: Join us on Discord.
• Support the project: TarkovTracker is free, ad-free, and maintained almost entirely by one developer. Becoming a supporter keeps updates coming.
• Translations: Help translate at translate.tarkovtracker.org. Available in English, Chinese, Czech, French, German, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, and Ukrainian.

---

For Developers and Contributors

The rest of this README covers local development and contributing. If you only want to use TarkovTracker, visit https://tarkovtracker.org — no setup required.

Local development

corepack enable        # enables pnpm via Corepack (Node per .nvmrc)
pnpm install
pnpm run dev           # http://localhost:3000

Copy .env.example to .env and fill in SUPABASE_URL and SUPABASE_ANON_KEY. These shared names are used by Nuxt, Cloudflare Pages/Workers, and Supabase Edge Functions, so the same values do not need to be duplicated under NUXT_PUBLIC_*. Without Supabase configured, the app runs in offline mode with localStorage only — auth, sync, realtime, and team features are unavailable.

SUPABASE_URL and SUPABASE_ANON_KEY are required for login/sync. Everything else is optional and documented in docs/architecture.md.

Tech stack: Nuxt 4 (prerendered public pages, client-side progression), Vue 3 Composition API, TypeScript (strict), Pinia, Supabase, Tailwind CSS v4, Vitest, Cloudflare Pages/Workers.

Common commands

Task	Command
Dev server	pnpm run dev
Build	pnpm run build
Preview build	pnpm run preview
Lint	pnpm run lint
Typecheck	pnpm run typecheck
Tests	pnpm run test
Test watch	pnpm run test:watch

Run pnpm run lint, pnpm run typecheck, and pnpm run test before pushing. The full command list (including i18n, Supabase types, OpenAPI validation, and the API gateway tests) is in AGENTS.md and docs/workflow-automation.md.

Contributing

Each pull request must address one change only — a single fix, update, doc improvement, or feature. PRs that bundle unrelated changes may be asked to split or be closed.

• How to contribute — issues, branches, PR process, and the PR template.
• Label system — issue types, scope, priority, ownership, and status.
• Project board — how issues move from backlog to done.

[!TIP] New to the codebase? Look for issues labeled good-first-issue — they are scoped for newcomers.

Documentation

The short version: this README gets you running; the docs/ folder explains how things work.

You want to…	Read
Get started	This README
Report a security vulnerability	SECURITY.md
Find where to get help	SUPPORT.md
Read the code of conduct	CODE_OF_CONDUCT.md
Understand the systems (caching, data, overlay)	docs/systems/
Understand the full architecture & data flow	docs/architecture.md
Read the Tarkov data architecture decision	docs/decision-tarkov-data.md
Use or extend the HTTP/API surface	docs/api.md
Understand rate limits / abuse controls	docs/rate-limiting.md
Deploy, configure env vars, or handle an incident	docs/runbook.md
Understand CI/CD, hooks, and releases

Start at docs/README.md if you are not sure which doc you need.

Project structure

app/         Nuxt 4 source (features, stores, server routes, shell, locales)
supabase/    Database migrations and edge functions
workers/     Cloudflare Workers (public API gateway)
scripts/     Precompute and other tooling
docs/        Project documentation
public/      Static assets

See docs/architecture.md for the full module map and docs/systems/ for how the non-obvious systems (Tarkov.dev integration, multi-layer caching, overlay corrections, precompute) actually work.

License

GNU General Public License v3.0 — see LICENSE.md.