🎯 Inspiration
The inspiration for ReddLogix came from a simple observation: most word puzzle games are predictable and repetitive. You see a definition, you fill in a word. Rinse and repeat. We wanted to create something that felt more like solving a mystery than filling in a crossword.
We were inspired by cryptic crosswords, escape rooms, and narrative-driven games that make you think laterally. The idea was: what if every puzzle told a story? What if instead of "a hard substance," the clue was "the foundation of every monument, cold and eternal"? That poetic, atmospheric approach became the heart of ReddLogix.
We also saw an opportunity in Reddit's new Devvit platform. Reddit has millions of users who love puzzles, wordplay, and daily challenges. Building directly on Reddit meant players wouldn't need to download apps, create accounts, or leave the platform they already love. It was the perfect match.
🎮 What It Does
ReddLogix is a daily word deduction game that runs natively on Reddit. Every day at 2 AM UTC, a fresh puzzle appears as a Reddit post. Players solve a 5×5 grid containing five interconnected 5-letter words by deciphering cryptic, narrative-driven clues.
Here's what makes it special:
Story-Driven Puzzles: Each puzzle has a unique atmospheric theme—"Lost Civilization," "Neo-Noir City," "Cosmic Horrors," "Arctic Expedition." The clues aren't dictionary definitions; they're poetic descriptions that evoke scenes and emotions. You're not just solving words; you're unraveling a narrative.
AI-Powered Generation: Using Google's Gemini AI, we generate completely unique puzzles with dynamic categories that never repeat. Every day brings a fresh theme you've never seen before, keeping the game unpredictable and exciting.
Interactive Gameplay: The 5×5 grid features auto-validation (words turn green when correct), full keyboard navigation, pre-revealed letter hints, and a smooth, mobile-first interface. You can solve words in any order, take as long as you need, and track your progress in real-time.
Community Features: Beyond daily puzzles, we've curated 28+ community puzzles with unique themes like "Cryptic Myths," "Alien Flora," and "Time Anomalies." Players can like puzzles, compete on leaderboards, view solve time distributions, and see a real-time completion timeline chart showing when other players finished.
Reddit-Native Experience: Everything happens within Reddit. No external links, no separate accounts. Click "Play Today's Grid" on the splash screen, and the game opens in full-screen mode right in the post. Your Reddit username is automatically authenticated, and your progress is saved.
🛡️ Moderator Controls & Loading States
ReddLogix features a comprehensive moderator control panel accessible exclusively to subreddit moderators via the red floating action button (⚙️).
The Moderator Modal includes two tabs:
Daily Puzzles and Community.
In the Daily Puzzles tab, moderators can reset the daily puzzle to clear cache and generate a new puzzle for testing, create a brand new Reddit post with a fresh puzzle and incremented number, or access the "Danger Zone" to clear all game data (puzzles, stats, and counters) with a two-step confirmation to prevent accidental deletion.
The Community tab displays user-submitted puzzles awaiting approval, showing each puzzle's category, briefing, cryptic clue, vote count, and like count, with a one-click "Approve" button to promote puzzles to the featured collection.
All actions feature loading states with animated spinners and disabled buttons to prevent duplicate operations—for example, "Resetting..." replaces "Reset Puzzle" while the operation is in progress, and the approve button shows a spinning icon with "Approving..." text.
The modal also includes a prominent warning banner at the top ("Moderator tools - use with caution") to remind moderators of the impact of their actions. Loading states are consistent throughout the app: the Community tab shows a centered purple spinning loader with "Loading community puzzles..." text when fetching data, and empty states display helpful messages like "No puzzles available for approval" when the queue is empty. These thoughtful loading indicators and confirmation dialogs ensure moderators can manage the game confidently without accidentally disrupting the player experience.
🛠️ How We Built It
We built ReddLogix using Reddit's Devvit platform, which allows developers to create interactive apps that run directly in Reddit posts. Here's our tech stack:
Frontend: React 19 with TypeScript for the game UI, Tailwind CSS for responsive styling, and Vite for lightning-fast builds. The client code handles the interactive 5×5 grid, clue navigation, modals, and all visual feedback.
Backend: Express server with TypeScript running on Devvit's Node.js environment. We built RESTful API endpoints for puzzle generation, submission tracking, statistics, likes, and community features.
Data Layer: Redis (via Devvit) for fast in-memory persistence. We store puzzles, completions, solve times, likes, and play counts with efficient key patterns for quick lookups.
AI Integration: Google's Gemini AI generates unique puzzle themes and cryptic clues. We built a validation pipeline that checks for profanity, ensures proper formatting, and falls back to 30+ curated backup puzzles if the API fails.
Automation: Cron jobs handle daily post creation at 2 AM UTC. The system automatically generates a new puzzle, creates a Reddit post, and increments the puzzle counter.
Architecture: We used a monorepo structure with three main folders:
src/client/ - React game interface
src/server/ - Express API and services
src/shared/ - TypeScript types shared between client and server
The build process compiles the client to static HTML/CSS/JS and the server to a CommonJS bundle that Devvit can execute.
🚧 Challenges We Ran Into
AI Puzzle Generation Reliability: Getting Gemini to consistently generate valid 5×5 grids with cryptic clues was tricky. We had to build robust validation (profanity filtering, format checking, duplicate detection) and a fallback system with 30+ backup puzzles to ensure players always have content.
Real-Time Statistics: Implementing the completion timeline chart was complex. We needed to fetch completion times, filter invalid data (zeros, negatives), dynamically scale the timeline, distribute dots vertically for visibility, and handle empty states—all while keeping the UI performant.
Mobile-First Design: Making the 5×5 grid work smoothly on mobile required careful touch target sizing, swipe gesture implementation for clue navigation, and responsive layouts that adapt to any screen size without breaking the game flow.
Redis Data Modeling: Designing efficient key patterns for Redis was challenging. We needed to support fast lookups by post ID, puzzle ID, username, and puzzle number while tracking completions, likes, solve times, and play counts without redundancy.
Auto-Validation Logic: Implementing the auto-validation system (words turn green when correct) required careful state management. We had to handle partial completions, prevent editing locked words, and update the UI instantly without lag.
Devvit Platform Constraints: Working within Devvit's serverless environment meant no long-running processes, no filesystem access, and a 30-second request timeout. We had to optimize API calls and ensure all operations completed quickly.
🏆 Accomplishments We're Proud Of
Dynamic AI-Powered Content: We successfully integrated Gemini AI to generate infinite unique puzzles. Every daily puzzle has a completely original theme and cryptic clues, making the game endlessly replayable.
Seamless Reddit Integration: The game feels like a native part of Reddit. Players don't need to create accounts, remember passwords, or navigate to external sites. Everything happens within the post, with automatic authentication and progress tracking.
Real-Time Completion Timeline: The animated completion chart on the splash screen is a visual highlight. Seeing yellow dots pulse and glow as players complete the puzzle creates a sense of community and competition before you even start playing.
28+ Community Puzzles: We curated a diverse collection of themed puzzles with unique categories like "Cryptic Myths," "Neo-Noir City," "Cosmic Horrors," and "Time Anomalies." Each puzzle has its own atmospheric briefing and cryptic clues.
Mobile-First UX: The game works beautifully on mobile with touch-optimized controls, swipe gestures, and responsive design. Most Reddit users are on mobile, so this was critical.
Comprehensive Statistics: We built a full stats system with solve time distributions, leaderboards, completion rates, and like tracking. Players can see how they stack up against the community.
📚 What We Learned
AI Prompt Engineering: We learned how to craft effective prompts for Gemini to generate consistent, high-quality puzzles. It required iteration, validation, and fallback strategies to handle edge cases.
Devvit Platform Capabilities: We gained deep expertise in Devvit's architecture—how to structure client/server code, use Redis efficiently, implement cron jobs, and handle Reddit authentication.
Cryptic Clue Design: Writing narrative-driven clues that evoke words without defining them is an art. We learned to balance difficulty, creativity, and clarity to make puzzles challenging but solvable.
Community Engagement: We discovered that social features (likes, leaderboards, completion charts) transform a solo puzzle game into a community experience. Players love seeing how they compare to others.
Performance Optimization: We learned to optimize React rendering, minimize API calls, and use Redis efficiently to keep the game fast and responsive even with thousands of users.
🚀 What's Next for ReddLogix
User-Generated Puzzles: We're planning a submission system where players can create and submit their own themed puzzles. The community will vote on submissions, and top-rated puzzles will be featured.
Multiplayer Mode: We want to add real-time competitive modes where players race to solve the same puzzle simultaneously, with live leaderboards updating as they play.
Achievements & Badges: A progression system with achievements for milestones like "Solve 10 puzzles," "Fastest time under 1 minute," or "Complete all community puzzles."
Themed Events: Special event puzzles tied to holidays, Reddit events, or pop culture moments with unique rewards and limited-time challenges.
Difficulty Levels: Options for Easy, Medium, and Hard puzzles with varying numbers of revealed letters and clue complexity.
Puzzle Editor: A visual tool for moderators to create custom puzzles with a drag-and-drop interface, making it easier to curate high-quality content.
Cross-Subreddit Leaderboards: Global leaderboards across all subreddits running ReddLogix, creating a larger competitive community.
Hint System: Optional hints for stuck players (e.g., "Reveal one letter" or "Show word length") with a small time penalty to keep it fair.
ReddLogix transforms word puzzles from a solitary, predictable activity into a daily narrative adventure with a thriving community. Every puzzle tells a story, every day brings something new, and every player becomes part of a shared experience on Reddit.
Log in or sign up for Devpost to join the conversation.