About Theriodex
Theriodex is an open-source Pokédex written in Ruby using Sinatra and a handful of other Ruby gems. It is – and will remain – completely ad-free and non-commercial! Its aim is to provide you with the most important information you need at a glance! Also try the Who's That Pokémon? guessing game and unlock more customisation options you can apply in the Settings!
It started out as a small project of mine but has turned into something much bigger! It is now the by far biggest project I have ever worked on and written myself and new features and bug fixes are still being added frequently! This is, however, very much a passion project and a programming excercise and, therefore, things have absolutely not been written or done in the most optimal of manners.
I highly recommend checking out this project’s official git repository, as you will be able to find the project’s README there which contains a bunch of planned features as well as instructions on how to run this yourself, if you so wish.
Features
Core Pokédex Information and Features
- All 1000+ Pokémon through Generation IX, including regional variants, mega evolutions and other special forms
- A quick overview of type damage, taking dual-types into account, so you can see at a glance what a Pokémon is weak or resistant to
- Full move learnsets (level-up, TM/HM, egg, tutor) with STAB highlighting
- Ability descriptions, plus which Pokémon can actually have them
- Base stats and full evolution overviews
- Plenty of sprites for all Pokémon from various generations
- A random Pokémon on the homepage if you just want to go and explore (there are so many Pokémon…)
- An evolution tree with information about when a Pokémon evolves into another and what requirements there are for its evolving
Browsing
- Filter by type, generation, and more
- A full item database with descriptions and effects
- Fast, fuzzy search across both Pokémon and moves
- Interface localisation
Game
- A "Who's That Pokémon?"-type guessing game, with blurred sprites, adjustable difficulty, and a daily challenge
- Filter by generation if you want to practise, say, only Gen 3
- A global leaderboard backed by Redis
Customisation
- A handful of pixel fonts to pick from
- Various themes, some of which you'll have to unlock by playing the game
- Custom CSS cursor packs
- Cards or table view, whichever you prefer for browsing
Acknowledgements
I want to thank the folk behind PokeAPI and Veekun’s Pokédex who are responsible for the data in this repository’s database. Thanks also to GGBotNet and VEXED for creating the fantastic pixel fonts I am using. Icons are from Iconoir.
A special and immense thanks also to all my partners – who are way better at programming and database queries than I am – for helping me out a lot and answering my questions and giving helpful tips. I definitely would not have been able to get as far with this project if it hadn’t been for them. Thank you, I love you all 💛
If you enjoy any of the fonts or icons and wish to use them yourself, please do consider not simply taking them from Theriodex, but going to their respective sites and either buying it from them or donating to them – just as I did, too.
Tech
Theriodex is powered – in one way or another – by Debian, Docker, Netcup, deSEC and Codeberg! We are, therefore, essentially fully hosted in Germany!
I used to mainly write my code in Doom Emacs but moved to VS Code, then Zed and now the Zed fork "Gram" mostly either on Linux (Linux on my Framework 13) or macOS (on my M4 MacBook Pro).
Copyright notices and attributions
Pokémon and Pokémon character names are trademarks of Nintendo, Game Freak, and Creatures Inc. Theriodex is not affiliated with, authorized, or endorsed by The Pokémon Company, Game Freak, Creatures, or Nintendo.
The project is licensed under the 3-Clause BSD License.
- Pixeloid font (main font): CC0 by GGBotNet
- Fonts (all fonts selectable in the Settings): CC BY 4.0 by VEXED
- Icons: MIT License by Iconoir
- Logo: The fantastic logo was made by my partner Coyote 💛
