Skip to content

Latest commit

 

History

History
37 lines (27 loc) · 1.36 KB

File metadata and controls

37 lines (27 loc) · 1.36 KB

Letter Soup App 🍲

A modern, mobile-first Progressive Web Application (PWA) for creating, playing, and sharing "Letter Soup" (Word Search) puzzles.

Try it out: https://letter-soup-rho.vercel.app/#/login

Features

  • Dynamic Grid Generation: Automatically places up to 12 secret words horizontally, vertically, and diagonally in a grid (default 10x10).
  • Shareable Links: Encodes your custom soup directly into the URL, allowing friends to play your level instantly in their browser without any database requirements!
  • Interactive Play: Tap letters to select them. Selected letters turn gray, and correctly found words burst into rainbow colors.
  • English Vocabulary Practice: Instantly generate random word searches to practice English vocabulary.
  • Modern Aesthetics: Built with a clean, glassmorphism-inspired UI and responsive mobile-first design using React.

Getting Started

First, ensure you have Node.js installed.

  1. Clone the repository and install dependencies:
    npm install
  2. Start the development server:
    npm run dev
  3. Open the local network link provided in the terminal (usually http://localhost:5173) in your browser.

Tech Stack

  • React
  • Vite
  • React Router
  • Lucide Reat (Icons)
  • Vanilla CSS

Built as a mobile-first PWA, easily portable to Android via capacitor.