Word Genie

Ultra-fast word solver for Gartic Phone and Guess The Build. Type the pattern you see, get instant matches in milliseconds. No signup, no ads, no waiting.

→ Try Word Genie Now • Report Bug • Request Feature

---

✨ Features

• 🎯 Real-time pattern matching — Type g_t_ and instantly see gato, gate, gotta (picks the right dictionary based on the game)
• 🌍 5 Languages — Español, Français, Italiano, Português, English — solvers optimized per language
• 📊 26,426+ curated words — Gartic drawings (9,053 PT + 5,313 EN + 3,461 ES + 3,331 FR + 3,392 IT) + Minecraft themes (1,876 EN)
• 📱 Mobile-first design — Large input field, instant copy-to-clipboard, works offline
• 🎨 Sketchbook-arcade aesthetic — Hand-crafted UI with stickers, shadows, graph paper, and playful animations
• 🚀 Instant results — Millisecond response times, zero page reloads
• ✅ 100% free — No subscriptions, no tracking, no hidden costs

---

🎮 How It Works

Gartic Phone / Gartic.io

1. See the pattern — Your team draws clues, you see revealed letters (e.g., _____ becomes s_l_t)
2. Type the pattern — Use _ for unknown letters
3. Copy a word — Pick the best match and paste into chat—round still running

Guess The Build (Hypixel Minecraft)

1. Spot the theme — Building reveals hints, letters appear (e.g., air h___)
2. Type with spaces — Multi-word themes stay intact
3. Build faster — Instant inspiration while the timer counts down

---

🚀 Quick Start

Development

# Install dependencies
npm install

# Start dev server (http://localhost:4321)
npm run dev

Building

# Build for production
npm run build

# Preview the build locally
npm run preview

Generate OG Image

# Edit scripts/og-image.svg, then regenerate the PNG:
node scripts/generate-og-image.cjs

---

📦 Tech Stack

Layer	Tech
Framework	Astro 7.1 (static HTML, minimal JS)
Components	React 19 (islands architecture)
Styling	Tailwind CSS + custom animations
Fonts	Bricolage Grotesque, Schibsted Grotesk, Spline Sans Mono
State	Zustand (for language/theme)
Animations	Framer Motion
Hosting	Cloudflare Pages
i18n	Astro native routing with custom utilities

---

🌐 Internationalization

The site runs in 5 languages with full localization:

• English → / (default, unprefixed)
• Português → /pt/
• Español → /es/
• Français → /fr/
• Italiano → /it/

Each language has:

• Translated UI (header, footer, FAQs, solver strings)
• Localized number formatting
• Language-specific default dictionary on solver pages
• hreflang alternates for SEO

Blog and legal pages (privacy, terms, disclaimer) are English-only for now.

---

📁 Project Structure

word-genie/
├── src/
│   ├── pages/                    # Astro pages (routing)
│   │   ├── index.astro           # EN home
│   │   ├── pt/, es/, fr/, it/    # Language-specific routes
│   │   ├── games/                # Game pages
│   │   ├── blog/                 # Blog articles
│   │   └── 404.astro             # Custom 404
│   ├── components/
│   │   ├── pages/                # Full-page components (HomePage, etc.)
│   │   ├── SimpleSolver.tsx      # Reusable pattern matcher
│   │   ├── Header.astro          # Navigation + language switcher
│   │   └── Footer.astro
│   ├── i18n/
│   │   └── utils.ts              # Localization helpers
│   ├── data/
│   │   └── words/                # JSON word lists (gartic, guess-build)
│   ├── layouts/
│   │   ├── Layout.astro          # Base layout (OG tags, fonts, etc.)
│   │   └── BlogLayout.astro      # Blog post template
│   └── styles/
│       └── globals.css
├── scripts/
│   ├── og-image.svg              # Social media preview (1200x630)
│   └── generate-og-image.cjs     # SVG → PNG converter (requires sharp)
├── public/
│   ├── og-image.png              # Generated OG image
│   └── ...
├── astro.config.mjs              # Astro config (i18n, integrations)
├── tailwind.config.ts            # Custom theme, animations
└── wrangler.toml                 # Cloudflare Pages config

---

🔗 Site Map

Route	Purpose
/	Homepage with pitch, stats, how-it-works
/games	Choose Gartic or Guess The Build solver
/games/gartic	Gartic pattern matcher (5 languages)
/games/guess-build	GTB theme matcher (English)
/blog	Articles on strategy and word lists
/about	Mission, team, commitments
/contact	Support and feedback
/privacy-policy	GDPR/privacy compliance
/terms	Terms of service
/disclaimer	Affiliation disclaimer

All main pages (home, games, about, contact) exist in 5 languages under /pt/, /es/, /fr/, /it/.

Live: https://wordgenie.lucashdo.com

---

🚀 Deployment

Cloudflare Pages (Recommended)

# Automatic via GitHub Actions on push
# Or manual:
npm run deploy

Setup:

1. Connect your repo to Cloudflare Pages
2. Build command: npm run build
3. Build output: dist
4. Environment: Node 18+

Local Preview

npm run preview

---

📊 Performance

• Lighthouse score: 95+ (performance, accessibility, best practices)
• Solver response: <50ms for 26K+ words (with memoization)
• Time to interactive: <1s (minimal JS)
• Core Web Vitals: All green

---

🤝 Contributing

We're always looking for:

• ✅ New words for Gartic lists (help us expand to more languages)
• ✅ Bug reports and feature suggestions
• ✅ UI/UX feedback
• ✅ Performance improvements

How to contribute:

1. Open an issue
2. Or start a discussion

---

📜 License

This project is licensed under the MIT License — see LICENSE for details.

In short: You're free to use, modify, and distribute this code for any purpose, as long as you include the original license and copyright notice.

---

⚖️ Legal Disclaimer

Word Genie is not affiliated with:

• Gartic Inc. (Gartic Phone, Gartic.io)
• Minecraft / Hypixel Studios / Mojang Studios / Microsoft Corporation

All game names and trademarks are property of their respective owners. This is a fan-made tool built to enhance the gaming experience.

---

📧 Support & Contact

• 🐛 Report bugs: GitHub Issues
• 💡 Suggestions: GitHub Discussions
• ❓ Questions: GitHub Discussions
• 🌐 Visit: wordgenie.lucashdo.com

---

Made with 🎨 by Lucas Henrique Diniz
For gaming communities, by gaming communities

⬆ back to top