Skip to main content

Quickstart

Get started with Tarkov Kappa Navi and begin tracking your journey to the Kappa container. This guide will help you set up the application and track your first quest.

Running the application

Tarkov Kappa Navi is a client-side web application that runs entirely in your browser. You can either access a hosted version (if available) or run it locally on your machine.
Since this is a local-first application, all your progress data is stored in your browser’s IndexedDB. Your data never leaves your device unless you explicitly export or share it.

Run locally

If you want to run the application on your local machine:
1

Clone the repository

git clone https://github.com/marlho/TarkovKappaNavi.git
cd TarkovKappaNavi
2

Install dependencies

npm install
3

Start the development server

npm run dev
The application will start at http://localhost:5173

First time setup

Once you have the application running, follow these steps to start tracking your progress:
When you first launch the application, you’ll see a welcome guide that introduces the main features. You can replay this guide anytime from Settings.
1

Set your player level

Navigate to Settings from the sidebar and set your current player level. This is important because:
  • Tasks are locked until you reach the required level
  • The app will only show you tasks that are currently available
  • Unlock calculations depend on your player level
Update your player level in Settings whenever you level up to ensure accurate task availability.
2

Start tracking your first quest

Go to the Tasks section to see all available quests:
  1. Use filters to find tasks by trader, map, or task type
  2. Click on any task to open the detail panel
  3. Review task objectives, required items, and rewards
  4. Mark tasks as complete when you finish them in-game
The task detail panel shows:
  • Prerequisite tasks that must be completed first
  • Task objectives and acceptance/completion requirements
  • Personal notes section for strategy planning
3

Pin active tasks to your dashboard

While viewing a task in the detail panel, pin it to your “Now” panel:
  1. Click the pin icon on any task you’re actively working on
  2. Return to Dashboard to see your pinned tasks
  3. Track up to 10 active tasks simultaneously
Your Now panel provides quick access to tasks you’re currently focusing on without navigating through filters.
4

View your Kappa progress

The Dashboard displays your overall progress:
  • Kappa progress bar: Shows completion percentage for Kappa-required tasks
  • Per-trader progress: Track progress with individual traders
  • Recommended tasks: Get smart suggestions based on downstream impact and map efficiency
  • Upcoming unlocks: See which tasks will become available soon
Check your dashboard regularly to monitor progress and plan your next steps.

Next steps

Explore other features

Map tools

Use interactive maps to plan routes and mark key locations with custom pins

Hideout planning

Track hideout station upgrades and manage item requirements

Share progress

Export your progress as JSON or share via QR code with friends

Item database

Browse items with price tier categorization

Understanding task recommendations

The Dashboard’s recommended tasks are scored based on:
  • Downstream impact: Tasks that unlock many other tasks get higher priority
  • Map batching: Tasks on the same map as other available tasks are grouped together for efficiency
  • Kappa requirements: Tasks required for the Kappa container are prioritized
Use these recommendations to optimize your quest completion order and minimize map switching.

Data backup and sharing

Your progress is stored locally in IndexedDB. Consider exporting your data regularly as a backup.
In Settings, you can:
  • Export to JSON: Download your complete progress data
  • Import from JSON: Restore previously exported data
  • Generate QR code: Share your progress with teammates
  • Import from QR: Load progress shared by others (includes integrity validation)

Wipe resets

When Escape from Tarkov has a game wipe:
  1. Go to Settings
  2. Use the Wipe Reset function to clear all progress
  3. Keep your player level or reset it to 1
  4. Start tracking from a fresh state

Build docs developers (and LLMs) love