pokemon/.github/copilot-instructions.md

Project Overview

This is a Pokémon finder web application built with Vite, Tailwind CSS, and vanilla JavaScript (ES Modules). It fetches data from the PokéAPI using the pokedex-promise-v2 library.

Key Features & Logic

• Search: Allows searching by text input or voice (Web Speech API).
• Display: Shows the current Pokémon's image, name, types, height, and weight.
• History:
  • Displays the last 3 successfully searched Pokémon.
  • Stores the full data object returned by the API for each history item.
  • The most recent item is displayed at 100% scale, the second at 90%, the third at 80%.
  • When a new Pokémon is successfully searched:
    • Any existing entry for that Pokémon is removed from the history array.
    • The new data object is added to the beginning of the history array.
    • The array is trimmed to a maximum of 3 items.
    • The history display is re-rendered.
    • The newly added/moved item animates in with a slide/fade effect (0.8s duration).
  • History items are clickable to re-trigger a search for that Pokémon.
• Icons: Font Awesome is used for icons, such as the microphone icon in the search input. Ensure the Font Awesome library is included in the project for proper rendering.
• Error Handling: Displays user-friendly messages, especially for "Not Found" (404) errors. Technical errors are logged to the console.

Build & Deployment

• Build Tool: Vite. Uses vite-plugin-node-polyfills to handle Node.js built-ins for browser compatibility.
• Containerization: Dockerfile uses a multi-stage build (Node build stage, Nginx serve stage).
• Deployment Script (deploy.sh):
  • Automates npm install, npm run build.
  • Optionally runs Playwright tests (--test or -t flag) against the production build served by vite preview.
  • Stops/removes the existing Docker container.
  • Builds the Docker image.
  • Runs the new Docker container.
  • Requires the user to be in the docker group for permissions.

Testing

• Framework: Playwright for E2E tests (tests/pokemon.spec.js).
• Execution: Can be run manually or via the deploy.sh --test flag.

Known Issues / Current Focus

• Refining the history update logic to avoid visual duplication or incorrect animation triggers when a Pokémon is re-searched. (As per user's last request).

Preferences

• Keep error messages user-friendly.
• Use Tailwind CSS for styling where possible.
• Maintain clear separation of concerns in the JavaScript code.