tarkov.dev 💻

This is the source code for the official tarkov.dev website.

View Escape from Tarkov information about items, barters, trades, flea market prices, quests, maps, hideout profits, and so much more!

Local Development 🔨

To build and test the site locally just follow the steps below:

0. Install Node.js

   # use nvm to install the correct version of Node.js
   nvm use
   

1. Install dependencies:

   npm install
   

2. Copy .env.example to .env (no values need to be changed)

3. Start development server:

   npm start
   

4. Access the site: localhost:3000 🎉

Note: You can update data with: npm run prebuild

VS Code Dev Container

1. Open VS Code command palette:

   cmd + shift + p / ctrl + shift + p
   

2. Start the dev container:

   > Dev Containers: open folder in container...
   

3. Select local path to tarkov-dev repo

4. After the container builds and starts it will auto run npm install && npm start

5. Access the site: localhost:3000 🎉

History 📚

This project (tarkov-dev) is a fork of tarkov-tools.com. The original creator @kokarn decided to shut the site down. In the spirit of open source, a group of developers came together to revive the site in order to continue providing a great website for the Tarkov community and an API to power further development for creators. This project is now 100% open source (see infrastructure section below) and developer first. Our GitHub Organization (the-hideout) contains all the repos which power the API, this website, the community Discord bot, server infrastructure, and much more! We are passionate about open source and love pull requests to improve our ecosystem for all.

We ❤️ Pull Requests

We love pull requests and contributors looking to improve this project! Anything from simple spelling errors, icon updates, fixes for small css bugs or just posting issues to keep track of what needs to be done is greatly appreciated.

Deployment 🚀

Deploying your changes to production is easy! Just do the following:

1. Open a pull request with your changes
2. Make sure CI is passing (a core member of the-hideout will run CI for you)
3. A core member of the-hideout will run .deploy to development to deploy your changes to the development environment for final validation
4. A review will be recieved from a reviewer if all looks good
5. A core member of the-hideout will run .deploy on your pull request to branch deploy your changes to production
6. If everything goes okay, your PR will be merged and your changes will be auto-deployed to production! ✨

Updating Languages 🌐

There are two ways to update languages on the site:

• Updating the core translations (most common)
• Updating the language that the GraphQL API uses (least common)

Language Translations

Rather than go into detail here, we have opened a great guide in a GitHub issue for how you can provide translation contributions to tarkov.dev!

Check out the guide here

GraphQL API Language Support

To update the supported languages used by the site with the GraphQL API, you will need to edit the following file: supported-languages.json

See this pull request for additional context

Other Parts of the Ecosystem 🌎

• Stash - The official tarkov.dev Discord bot
• Tarkov API - The GraphQL API that powers everything
• Tarkov Data - Open source structured data for Escape from Tarkov
• Tarkov Image Generator - Tool to generate images from the local icon cache
• Tarkov Data Manager - Data manager that core contributors to the project can use to update items in the database. It also contains cron jobs that sync database information to our Cloudflare workers for the GraphQL API
• Cache - A bespoke caching service to cache frequent GraphQL API queries
• Status - The official status page for tarkov.dev, api.tarkov.dev, and much more

Infrastructure 🧱

To learn more about the infrastructure, components, and open source pieces of this project, check out our infrastructure documentation

Contributors 🧑‍🤝‍🧑

Thank you to all of our awesome contributors! ❤️