Mini Pokemon Adventure app

A remake of my Mini Pokemon Adventure App utilizing React to handle the frontend instead of only Javascritpt so modifications were made to the code. However, the overall design was kept the same from the user perspective so the demo video for the original would still be relevant for working the app as a user.

• Link to the original version: https://github.com/AnthonyWeathers/Specs-Capstone
• Note: CSS and style of elements will be different due to changes having to be made to accomodate the usage of React versus use of AJAX requests with Javascript

Technologies used:

• React/Javascript (front-end)
• Python (back-end)
• Flask
• HTML, CSS
• postgresSQL

Features:

• Login:

  • Requires a username and password that has been registered into the database
  • Redirects to main page if login was successful
  • Shows as an alert

• Register:

  • Requires a username, password, and re-entered password before clicking register button
  • Needs a unique username that has not already been used, otherwise gives alert of “user already exists”
  • Redirects to login page with success message
  • Displays on Login screen if registration was successful

• Main/fortune:

  • Allows user search for random pokemon, go to PC, or logout

• Encounter:

  • Clicking "Search for wild pokemon" will redirect to an encounter page
  • Will display a randomly selected pokemon from all that has been added to the PokeAPI
  • Will display a message saying "Loading..." as the backend communicates with PokeAPI before displaying the selected pokemon
  • The pokemon has a 10% chance of being a shiny variant
  • Displays message of "A wild {pokemon name} has appeared
  • Has capture or flee buttons
  • Pokemon sprite changes to a regular pokeball
  • Text changes to indicate pokemon was captured
  • A return option is shown for user to go back to the main page
  • Page is kept the same except the message of "A wild {pokemon name} has appeared" is changed to it avoided the pokeball
  • User can attempt to capture the pokemon over and over until they catch it or decide to flee
  • Currently set capture rate to 50% but the condition can be modified

• PC:

  • All pokemon the user has caught will be displayed in the order they were caught
  • Clicking on a pokemon will make a details link appear, clicking it will redirect to the pokemon details page

• Pokemon Details:

  • Displays details of the pokemon
    • 4 moves that the pokemon could learn in the games with their name, power, accuracy, and pp
    • The pokemon's name
    • Pokemon type
    • The pokemon's sprite
    • Has Rename, Back, and Release options
  • Clicking Rename will make a box appear to type a new name and a update name link
  • Inputting a new name and clicking update name will automatically update the pokemon's name
  • Clicking release will delete the pokemon from the database and remove them from the PC list
  • Redirects user back to PC with the message displayed above

• Who's That Pokemon:

  • A random pokemon outline will be shown and a guess can be made
  • 3 guess are given to get the pokemon correct (letters can be either upper or lowercase, as long as spelling is correct)
  • If user guesses correctly then the pokemon is revealed and shows the text
  • If user guesses incorrectly, then pokemon and its name is revealed
  • Can play again with a new random pokemon selected

• Filter for PC:

  • Can filter the caught pokemon via their typing (for example, only fire type pokemon user has caught would be displayed if user selects Fire from the filter list)

Instructions on how to run a cloned repo

If a user wishes to try this app out on their own device, then there is some requirements needed to run this as I did, or equivalents:

• Programs used (may use equivalents if similar):

  • Visual Studio Code
  • Git
  • PostgreSQL (to setup the basebase name, password, and server port)

• Steps to install:

  • clone repo: git clone {insert github repo link of project}
  • create a virtual environment with python version 3.12.2
  • at the root of the directory (where you'd see the public, server, and static folders, and other files), open terminal (I used a Git Bash terminal) and run "pip install -r requirements.txt"
  • next is to add/create a 2nd terminal that is also at the root of the directory, and run npm i or npm install to install all dependencies from the package.json that the app needs for the frontend. Also keep that 2nd terminal open for setup/running the app
  • download pgAdmin4 and make a user, make password without a "?", setup a database, and find the server port of it
    • create a config.sh file
      • create "export POSTGRES_URI=" and set = to postgres://postgres:{password}@localhost:{port}/{database name}
        • you would replace {password} with the password you use to access your database
        • replace {username} with the name of user account you created in Login/Group Roles with super user and can login
        • replace {port} with the port assigned to PostgreSQL 16, or the server under Servers that has your database
        • replace {database name} with the name you gave the database that will be used on local device
        • result would be export POSTGRES_URI=postgresql://{username}:{password}@localhost:{port}/{database name}

• To Setup and Run App:

  • in the terminal, enter "source config.sh"
  • then if you're setting up for the first time, or want to reset the database, then enter "python seed_database.py" (if using python 3)
  • After setup, enter "python server.py", the backend of the app will be live
  • Then on the 2nd terminal, enter npm start, which would start the React server for the frontend. Should it work then it would have opened the app at its url on your browser, displaying the login page
  • Now you can use the app
  • Note: If you close visual studio code and relaunch it, you'll need to redo "source config.sh" before "python server.py" and "npm start", because source config.sh establishes the connection to your database