NationalDex

A fast, beautiful, and feature-rich Pokedex built for trainers who want instant access to everything Pokemon.

What is this?

NationalDex is a modern web-based Pokedex covering the full National Dex across all generations. It goes beyond a simple lookup tool — you can search for any Pokemon, move, ability, or item instantly, build and manage teams with type coverage analysis, compare Pokemon side by side, track favorites, and create custom lists. It works offline as a PWA and supports dark mode.

Key features

• Instant search across Pokemon, moves, abilities, and items
• Team builder with type coverage analysis and Showdown import/export
• Pokemon comparison with side-by-side stat breakdowns
• Favorites and custom lists persisted in local storage
• Location finder for Pokemon across all regions and games
• PWA support — installable on any device for a native-like experience
• Dark mode with automatic theme detection

Running locally

# Clone the repo
git clone https://github.com/TimMikeladze/nationaldex.git
cd nationaldex

# Install dependencies
bun install

# Start the dev server
bun dev

Open http://localhost:3000 in your browser.

No database or environment variables are required. All Pokemon data is bundled at build time or fetched from public APIs. User data (favorites, teams, lists) is stored in the browser's local storage.

Available scripts

Command	Description
bun dev	Start the development server
bun build	Build for production
bun start	Start the production server
bun lint	Run linting and format checks
bun lint:fix	Auto-fix linting issues

Contributing

1. Fork the repo and create your branch from main
2. Run bun install to set up dependencies
3. Make your changes and verify they pass bun lint and bun build
4. Open a pull request

Data attribution

• PokeAPI — Pokemon data and game information
• pkmn/ps — Sprites and competitive data

Pokemon is a trademark of Nintendo / Creatures Inc. / GAME FREAK Inc. This project is not affiliated with or endorsed by any of these companies.