/tarkov-dev

The official site for tarkov.dev - A web app to track item prices, view trader barters, quests, maps, and much more!

Primary LanguageJavaScriptMIT LicenseMIT

tarkov.dev 💻

deploy ci CodeQL contributors Discord

react JS

stars

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!

homepage

Local Development 🔨

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

  1. Install dependencies:

    npm install
  2. Start development server:

    npm start
  3. Access the site: localhost:3000 🎉

Note: You can update data with: npm run prebuild

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! ❤️