Showdex

<p align="center"> <img alt="showdex-icon" width="250px" src="./src/assets/favicons/showdex-1024.png"> </p> <h1 align="center"> <a href="https://github.com/doshidak/showdex"><code>showdex</code></a> </h1> <table align="center"> <thead> <tr> <th align="center">&nbsp;Currently <a href="https://github.com/doshidak/showdex/releases/tag/v1.3.0">v1.3.0</a>&nbsp;</th> <th align="center">&nbsp;Install on <a href="https://chrome.google.com/webstore/detail/dabpnahpcemkfbgfbmegmncjllieilai">Chrome</a> · <a href="https://chrome.google.com/webstore/detail/dabpnahpcemkfbgfbmegmncjllieilai">Opera</a> · <a href="https://addons.mozilla.org/en-US/firefox/addon/showdex">Firefox</a> · <a href="https://apps.apple.com/us/app/enhanced-tooltips-for-showdown/id1612964050">Safari</a>&nbsp;</th> <th align="center">&nbsp;Discuss on <a href="https://smogon.com/forums/threads/showdex-an-auto-updating-damage-calculator-built-into-showdown.3707265">Smogon</a> · <a href="https://discord.gg/2PXVGGCkm2">Discord</a></th> </tr> </thead> </table> <br>

Showdex is a browser extension for Pokémon Showdown that brings the Damage Calculator you know & love right into your battle! Automatically syncs all Pokémon & field conditions as you play, so you can spend less time shitting brix & more time hitting kicks.

<br>

Officially supported on Chrome (+ any native Chromium browser, like Arc, Edge & Brave), Opera & Firefox.

<details> <summary> <strong> &nbsp;&nbsp;༼ つ ಥ_ಥ ༽つ&nbsp;&nbsp;Safari </strong> &nbsp;...? </summary>

---

Despite Apple requiring us to shell out $100/year for the Apple Developer Program just to distribute a singular free extension on the App Store, thanks to the many generous contributions from the awesome Showdown community over the years, we're now planning on officially supporting Showdex on iOS & macOS in the future!

In the meantime, Enhanced Tooltips for Showdown (Source on GitHub), currently available on the App Store, bundles Showdex along with the Enhanced Tooltips & Randbats Tooltip extensions. Note that the bundled Showdex is not officially supported, so questions regarding Showdex running on Safari should be directed towards the maintainer of the aforementioned App Store app, Christian Brüggemann (Smogon · GitHub).

Would you like to know more? | --- |

</details> <br> <h3 align="center"> Navigation </h3> <table align="center"> <thead> <tr> <th>&nbsp;<a href="https://github.com/users/doshidak/projects/1">Planned Features</a>&nbsp;</th> <th>&nbsp;<a href="https://github.com/users/doshidak/projects/2">Known Bugs</a>&nbsp;</th> </tr> </thead> </table> <table align="center"> <thead> <tr> <th>&nbsp;<a href="#issues">Suggest a Feature</a>&nbsp;</th> <th>&nbsp;<a href="#issues">Report a Bug</a>&nbsp;</th> <th>&nbsp;<a href="#--contributing">Contribute · Translate</a>&nbsp;</th> </tr> </thead> </table> <table align="center"> <thead> <tr> <th>&nbsp;Powered by <a href="https://github.com/doshidak/showdex-calc"><code>showdex-calc</code></a> · <a href="https://github.com/doshidak/showdex-calc/releases/tag/v1.3.0">v1.3.0</a>&nbsp;</th> </tr> </thead> </table> <table align="center"> <thead> <tr> <th>&nbsp;Served by <a href="https://github.com/doshidak/bakedex"><code>bakedex</code></a> <a href="https://bake.dex.tize.io">Repository</a> · 2025.09.27&nbsp;</th> <th>&nbsp;<a href="https://github.com/pkmn/smogon"><code>@pkmn/smogon</code> <a href="https://data.pkmn.cc">Repository</a></th> </tr> </thead> </table> <br> <br> <br> <h1 align="center"> Developer Zone </h1>

[!CAUTION] You are about to get in the zone, the developer zone.
If you do not wish to get in the zone, the developer zone, please visit the Smogon Forums post instead.

<br>

Developer SparkNotes™

[!NOTE] This section is a work-in-progress.

This extension is written in TypeScript, which is essentially JavaScript on crack, using:

• React for the UI frontend (e.g., Hellodex, Calcdex),
• Redux for global state management (e.g., Calcdex state),
• RTK Query for global data management (e.g., downloaded Smogon sets),
• Babel for TypeScript transpilation (in lieu of tsc),
• ESLint for suggestive code linting, and
• webpack for chunking & bundling.

<details> <summary> <table> <thead> <tr> <th>&nbsp;How It's Made™&nbsp;</tm> </tr> </thead> </table> </summary>

---

[!NOTE] More information coming soon!

uhhhhhhhhh

---

<br> </details>

Requirements

[!IMPORTANT] Due to the removal of --experimental-specifier-resolution=node starting in node v19, v18 is required (i.e., ^18.0.0) to build this project. Use something like nvm to install v18 (nvm install lts/hydrogen) alongside your current node installation.

• node LTS Hydrogen v18
• yarn Classic v1.22.0+
• bash (Windows WSL, macOS, or Linux)

<br>

①  Setup

[!TIP] If your browser is already configured for extension development, you can skip this part. If you're building for 'standalone', don't skip this part.

When building this as an extension (i.e., the BUILD_TARGET env is either 'chrome' or 'firefox'), you'll need to apply some slight tweaks to your browser in order to directly install extensions from your local disk.

<details> <summary> &nbsp;<strong>Google Chrome</strong> </summary>

---

1. Navigate to the Chrome extensions page (chrome://extensions).
2. Enable Developer mode in the top-right corner.
3. Verify that the Load unpacked option is available.

---

</details> <details> <summary> &nbsp;<strong>Mozilla Firefox</strong> </summary>

---

1. Navigate to the Advanced Preferences page (about:config).
2. Search for the preference xpinstall.signatures.required.
3. Set the preference's value to false (typically true by default).
4. Navigate to the Debugging page (about:debugging).
5. Select This Firefox on the left-hand panel.
6. Verify that the Temporary Extensions section and the Load Temporary Add-on... option are available.

---

</details> <details> <summary> &nbsp;<strong>Mozilla Firefox for Android</strong> </summary>

---

[!INFO] More information coming soon!
Though instructions aren't currently provided, this project supports developing on Firefox for Android Nightly.

For now, see these instructions from Mozilla for setting up your Android device and Firefox for Android Nightly installation for extension development.

---

</details>

When building in 'standalone' mode (for embedding Showdex into your own pokemon-showdown-client), you'll need to mimic what the content script does in your client's index.html file.

<details> <summary> &nbsp;<strong>Standalone</strong> </summary>

---

[!IMPORTANT] Standalone builds remove all Web Extension API dependencies so that Showdex can be directly embedded into your pokemon-showdown-client. This includes the manifest.json, which will be omitted completely during the build process. That being said, you'll be manually doing what the content.js script would do to the index.html file in the following steps.

[!CAUTION] This is considered to be an experimental feature. In other words, it's untested beyond the build process as I don't have my own pokemon-showdown-client to run this off of (surprising, I know), but in theory, it shou