Building WoWdb

Ali Zahid
Ali Zahid
Jun 27, 2019 · 5 min read

WoWdb is a mobile World of Warcraft database. It’s built with React, React Native, Fastify, MongoDB, and Render.

I built Mr. Bigglesworth, an app that would let you search for World of Warcraft content and view Wowhead comments for them. It was based on an in-game cat.

It was a pretty simple solution. I wrote a script in Node.js, which would use the Blizzard APIs to fetch data. Which I then transferred to my MongoDB Atlas database. I also wrote an API in Node.js, which would search through the items, quests, achievements, etc, and return to the mobile app, along with comments from Wowhead. Mobile app was built with React Native.

It was a decent setup, but had its drawbacks.


  • Search was a poor experience; MongoDB text search is rather limited, and has no typo tolerance or scoring algorithm. So any searches for guldanwould return nothing because the data stored is Gul’dan.
  • App Store and Google Play reviews were bad. Their main grief was that it only lets you search and view Wowhead comments, and not see details about the objects. Which, to be fair, was the intended and marketed purpose of the app.
  • Because the data fetching and updating was a manual process, I hadn’t updated it since I first released the app over a year ago. WoW releases new content all the time, and some data just wasn’t there to be searched.

In 2019, I plan to retire some of my old apps that have no installs or don’t make sense anymore. And focus more on the ones that do.

As part of this restoration effort, I decided to rebuild Bigglesworthwith a few changes.


  • Let users see details about items, mounts, quests, etc. As much as I can get from the Blizzard APIs.
  • Better, faster search with typo tolerance.
  • Because I couldn’t find someone who could do a Mr. Bigglesworthicon for me cheaply, I decided to rebrand the app to WoWdb. I chose that capitalization as to not conflict with WoWDB, a competitor to Wowhead.

Finding the right infrastructure

A major hurdle to the ideal setup was my infrastructure.

I was hosting the API on Heroku, which would connect to MongoDB and fetch data, search, and hit up Wowhead for comments. It was fast and it worked. But that was it. It was expensive, so I was still doing the data updates manually, and rarely.

Recently, Google Cloud introduced Cloud Scheduler, and it was cheap. I looked into it. But before I could finalize it, I came across Render. Suddenly, so many new doors opened.

To improve search, I wanted to use Algolia. But my project didn’t fit their criteria for open source, and had enough data to cost $500 a month. Which, WoWdb being a side project, I just didn’t wanna spend. So I decided to write my own little service just for search.

The ideal setup

I sat down and started to draw out what the ideal setup would be like. My requirements were simple.

  • A place to host the REST API
  • A microservice for search
  • A weekly cronjob for updating data
  • Hosting for a single page React landing page

Luckily, Render offered everything in one place. Cronjobs, microservices, static site hosting. And cheap, too!

  • $5 a month for web and micro service each
  • $2 a month for cronjobs
  • Free static sites

Now that I could built everything in one place, I got to work.


First, I rewrote the data miner. Blizzard recently sunsetted their old APIs. So I had to fix my script to fetch from the new API. Improvements were also made. Decided to add spells, a missing collection of data, to the miner.

Then I wrote the new search microservice. It loads all data from MongoDB, and uses FuzzySearch to run queries. I also tried the more popular Fuse, but couldn’t get decent performance. Not sure if it was my configuration, or just the sheer size of my dataset. Roughly 550k records! Average search time with Fuse was 1 second. It was a mere 100 milliseconds with Fuzzy!

When this effort started and before I had decided to run everything on Render, I updated the Heroku app with a v2 API. But soon realized it was a mistake because things were changing considerably and it would simply be cleaner to leave the Heroku app as is and drop all v1 code and deploy v2 straight to Render.

The new API removed search from it. It just passed the query to the microservice, and returned the data to client. Refactored a ton of code. Just general improvements and learnings since last year when I first wrote it.

The mobile app was probably the largest change. New views, bug fixes, design, etc. Building the details views for items, mounts, achievements, etc, was the trickiest part. A lot of time and testing went into that. It was pretty much a complete rewrite. Which I always love!

I’m quite pleased with the results. It’s a very neat setup. Everything is updated to the latest version of everything. It was incredibly fun to work on. But it’s still not perfect.

Things to do

There’s still a few improvements that can be made.

  • Render currently only hosts services in US west. My MongoDB Atlas cluster is in Ireland. Most of the app’s potential users are also in EU. The latency is a huge problem right now. Luckily, it’s on their roadmap to add support for EU and other regions. But until then, it’s a bit slow in the rest of the world.
  • Blizzard APIs have limited data and even fewer attributes than would be truly useful. Wowhead, on the other hand, data mines the game files and has way more data than I can get from Blizzard APIs. Perhaps in the future, I could crawl Wowhead instead. But that’s a slippery slope and a conversation for later.
  • I lost my Android signing key! Luckily, I had the app enrolled in Google Play Signing, and their support team was very helpful in helping me update my key. The Android update should be live over the next few days. The iOS update is already available in App Store.
  • I want to redesign the visuals of the app, to match the Battle for Azeroth website. I think it’s fantastic artwork, which people will really appreciate. I redesigned my guild’s website last year from the Legion design and it was a hit.

Head on over and check out the updated app. As always, my side projects are completely open source. You can find the code on GitHub.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store