Wordle Helper

A web app to help solve Wordle puzzles by filtering words based on known letters and suggesting the best next guesses.

Features

• Filter by constraints: Enter correct positions, present letters, and absent letters
• Top suggestions: Words ranked by letter frequency from the Word Bank
• Elimination words: Suggestions that test common letters not yet in your known set
• Word sources: Toggle between Word Bank (2,315 words) and Valid Words (12,972 words)
• Letter frequency analysis: Script to analyze letter frequencies in the word bank

Usage

1. Enter letters you know in their correct positions (e.g., a..e.)
2. Enter letters you know are in the word but not their positions
3. Enter letters you've confirmed are NOT in the word
4. Get filtered results and suggestions for your next guess

Development

# Install dependencies
pnpm install

# Run dev server
pnpm dev

# Run tests
pnpm test

# Build for production
pnpm build

# Analyze letter frequencies
pnpm run analyze

Deployment to GitHub Pages

This app is configured to deploy automatically to GitHub Pages via GitHub Actions.

Setup

1. Push this repository to GitHub
2. Go to Settings → Pages in your GitHub repository
3. Under Build and deployment, select GitHub Actions as the source
4. The workflow will automatically deploy on every push to main

Manual deployment

The GitHub Actions workflow (.github/workflows/deploy.yml) will:

1. Install dependencies with pnpm
2. Build the static site
3. Deploy to GitHub Pages

Your site will be available at https://<your-username>.github.io/wordle-helper

Data

• static/word-bank.csv: 2,315 common 5-letter words (Wordle solutions)
• static/valid-words.csv: 12,972 valid 5-letter words (allowed guesses)
• static/letter-frequencies.json: Letter frequency analysis generated by scripts/analyze-words.ts