patriciadadzie
README.md

Twin Name Generator

An AI-powered tool for generating rhyming and similar names for twins with customizable gender preferences.

Features

  • Gender Options: Choose from boy/boy, girl/girl, or boy/girl twin combinations
  • Name Styles:
    • Rhyming names (names that rhyme or have similar endings)
    • Similar sounding names (names with similar sounds or patterns)
  • Length Preferences: Short (3-5 letters), any length, or long (6+ letters)
  • AI-Powered: Uses OpenAI GPT-4o-mini to generate creative and meaningful name pairs
  • Beautiful UI: Clean, responsive design with gradient cards and smooth animations

How It Works

  1. Select your gender preference for the twins
  2. Choose between rhyming or similar sounding names
  3. Pick your preferred name length
  4. Click "Generate Twin Names" to get 10 unique name pairs
  5. Each suggestion includes an explanation of why the names work well together

API Endpoint

  • POST /api/generate-names: Generates twin name suggestions
    • Body: { genderPreference, style, nameLength }
    • Returns: Array of name pairs with explanations

Technology Stack

  • Backend: Hono framework with TypeScript
  • AI: OpenAI GPT-4o-mini for name generation
  • Frontend: Vanilla JavaScript with TailwindCSS
  • Platform: Val Town serverless environment

Usage

Simply visit the web interface and fill out your preferences to get personalized twin name suggestions. The AI considers factors like sound patterns, cultural appropriateness, and complementary meanings when generating names.