Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Navi-27/Proyecto-UPC/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through everything required to run Pokédex Web App on your local machine. By the end, you will have a fully functional Flask server running at http://127.0.0.1:5000 with all 1025 Pokémon loaded, a working SQLite database, and the ability to register an account, browse the Pokédex, and build your personal team.
1

Clone the repository

Download the project source code from GitHub:
git clone https://github.com/Navi-27/Proyecto-UPC.git
cd Proyecto-UPC
2

Create and activate a virtual environment

Using a virtual environment keeps the project’s dependencies isolated from your system Python installation.
# Windows
python -m venv venv
venv\Scripts\activate

# macOS/Linux
python -m venv venv
source venv/bin/activate
Your terminal prompt should now show (venv) to confirm the environment is active.
3

Install dependencies

Install all required packages from requirements.txt:
pip install -r requirements.txt
This installs the following packages:
PackagePurpose
flaskWeb framework and routing
requestsHTTP client for PokéAPI calls
gunicornProduction WSGI server
werkzeugPassword hashing and security utilities
4

Run the development server

Start the Flask development server directly with Python:
python application.py
Alternatively, use the Flask CLI:
flask --app application run
You will see log output in your terminal as the app initialises the SQLite database and begins fetching Pokémon data.
5

Open the app in your browser

Navigate to http://127.0.0.1:5000 in your browser.On first launch, the app calls PokeAPI.obtener_lista_pokemones(limite=1025) to download all 1025 Pokémon from https://pokeapi.co/api/v2 and saves them to the local pokedex.db SQLite cache. Watch the terminal for Descargando N/1025... progress messages.
First-run download: The initial startup fetches all 1025 Pokémon from PokéAPI one by one, which can take a few minutes depending on your internet connection. Once complete, all Pokémon are stored in the local pokedex.db SQLite database and every subsequent start loads instantly from the cache — no network calls required.

What’s next?

Browsing Pokémon

Learn how to search by name, filter by type, and read the detailed stat view.

Account Registration

Create an account to unlock personal Pokédex tracking and the team builder.

Team Builder

Add up to 6 Pokémon to your personal team and manage your roster.

Project Structure

Explore how routes, models, services, and templates are organised.

Build docs developers (and LLMs) love