Expo SDK Platforms TypeScript

A React Native multiplatform helper app for solving Wordle puzzles faster! Built with Expo, this app analyzes your guesses and provides real-time word suggestions.

• Interactive Virtual Keyboard: Tap letters and assign status colors (green/yellow/gray)
• Smart Word Filtering: Real-time suggestions based on your guess history
• Wordle-Style Interface: 6 guess rows with 5 letter tiles each
• Smooth Animations: Color transitions and scale effects using Reanimated
• Haptic Feedback: Tactile responses for better user experience
• Hard Mode Support: Enforces use of revealed hints in subsequent guesses
• Dark Mode: Automatic system theme detection
• Multiplatform: Works on iOS, Android, and Web

1. Install Expo Go on your iOS or Android device
2. Scan the QR code below (available after first EAS build is published)

🔲 QR code will appear here after the first production build is published to Expo.

1. Tap a letter from the virtual keyboard
2. Select the status of that letter:
   • ✓ Green (Correct): Letter is in the word and in the correct position
   • ? Yellow (Wrong Spot): Letter is in the word but in the wrong position
   • ✗ Gray (Not In Word): Letter is not in the word at all
3. Continue entering letters until you fill a row
4. View suggestions - The app shows up to 20 possible words that match your clues
5. Tap any filled tile to cycle through status colors
6. Reset to start a new puzzle

• Node.js (v18+)
• Expo CLI

1. Install dependencies:

   npm install

2. Start the app:

   npx expo start

3. Run on your preferred platform:

   • Press i for iOS simulator
   • Press a for Android emulator
   • Press w for web browser
   • Scan QR code with Expo Go app

This project uses EAS Build for production builds and EAS Update for OTA updates.

npm install -g eas-cli
eas login

# Build for both platforms (production)
npm run build:all
# Build for a specific platform
npm run build:ios
npm run build:android
# Build development client
eas build --profile development --platform ios

Before submitting, fill in the credentials in eas.json:

• iOS: appleId, ascAppId, appleTeamId
• Android: path to your google-services-key.json

npm run submit:ios
npm run submit:android

Push a JavaScript update to users without a full build:

npm run update

WordleWizard/
├── app/ # Expo Router screens
│ ├── _layout.tsx # Root navigation layout
│ ├── modal.tsx # Modal screen
│ └── (tabs)/
│ ├── _layout.tsx # Tab bar configuration
│ ├── index.tsx # 🏠 Main game screen
│ ├── explore.tsx # i️ Instructions screen
│ └── settings.tsx # ⚙️ Settings (theme, hard mode)
├── src/
│ ├── components/
│ │ ├── LetterTile.tsx # Animated letter tile
│ │ ├── GuessRow.tsx # Row of 5 letter tiles
│ │ ├── VirtualKeyboard.tsx # QWERTY keyboard with status selector
│ │ └── WordSuggestionsList.tsx # Scrollable word suggestions
│ ├── types/
│ │ └── wordle.ts # TypeScript interfaces
│ ├── utils/
│ │ ├── wordFilter.ts # Word filtering algorithm
│ │ └── hardModeValidator.ts # Hard mode validation logic
│ └── data/
│ └── wordList.ts # 2300+ valid Wordle words
├── assets/ # Images, icons, fonts
├── app.json # Expo configuration
├── eas.json # EAS Build & Submit configuration
└── package.json # Dependencies & scripts

Contributions are welcome! Here's how to get started:

1. Fork this repository
2. Create a branch: git checkout -b feature/your-feature-name
3. Make your changes and ensure the app runs correctly
4. Lint your code: npm run lint
5. Commit: git commit -m "Add your feature"
6. Push: git push origin feature/your-feature-name
7. Open a Pull Request

Please keep PRs focused on a single feature or fix.

This project is open source and available for personal use.