README.md

Pokémon Matcher

A fun web application that uses AI to match famous people (or yourself!) to Pokémon that best represent them.

Features

• Match people to Pokémon based on personality, traits, and characteristics
• Get detailed explanations about why a particular Pokémon matches
• User-friendly interface built with SolidJS
• AI-powered matching using Anthropic Claude

Technologies

• Bun - JavaScript runtime
• SolidJS - UI framework
• TypeScript - Type safety
• Anthropic Claude API - AI matching

Getting Started

Prerequisites

• Bun installed on your machine
• An Anthropic API key (for production use)

Installation

1. Clone the repository
2. Install dependencies:

bun install

3. Set up environment variables:

cp .env.example .env
# Edit .env and add your Anthropic API key

Development

Start the development server (uses Vite):

bun run dev

Visit http://localhost:3000 to see the application.

Note: The app uses mock data by default to avoid consuming API credits. To use the real Anthropic API, set useMockData = false in src/routes/Match.tsx and provide your API key in the .env file.

Building for Production

Build the application:

bun run build

Preview the built files:

bun run serve

Project Structure

• /src - Application source code
  • /components - Reusable UI components
  • /routes - Page components
  • /lib - Utilities and API clients

License

MIT

---

This project was built with Bun v1.2.2.