kephothoX/WordDeck

An innovative real-time multiplayer word formation puzzle game built for Reddit using Devvit. Challenge yourself to form valid English words by selecting letters from a dynamic grid within timed 4-minute sessions, compete on global leaderboards, and engage with the community through real-time chat!

Word Deck is a revolutionary word formation game that transforms the traditional word puzzle experience into an immersive, futuristic gaming adventure. Players interact with a stunning letter grid displayed in a beautiful space-themed interface with animated cosmic backgrounds, floating particles, geometric shapes, and neon lighting effects. The goal is to spell valid English words within intense 4-minute timed sessions while competing against other Reddit users in real-time.

What sets Word Deck apart is its unique "click-and-experiment" mechanic combined with a strategic "clear-and-retry" system. Letters can be selected from anywhere on the grid (no adjacency required), and once you submit a word, those letters are permanently removed from the board. However, before submitting, you can experiment freely using the clear button to restore selected letters and try different combinations, creating a perfect balance between strategic planning and permanent consequences.

The game combines the intellectual challenge of word formation with the excitement of real-time competition, community interaction, and visual spectacle. Players must balance speed with strategy, as every submitted word permanently alters the game board and affects future possibilities. The ultimate goal is to remove as many letters as possible while maximizing your score and climbing the global leaderboard against other Reddit users.

🎯 Revolutionary Gameplay Mechanics:

• Strategic Click-and-Experiment System: Letters are selected when clicked and show visual feedback, but you can experiment freely using the clear button to restore them before final submission
• Non-Adjacent Freedom: Select letters from anywhere on the grid - no adjacency rules, path restrictions, or connection requirements
• Real-Time Word Building: Watch your word form letter-by-letter with glowing neon effects, numbered selection indicators, and pulsing animations showing your exact sequence
• Dual-Phase Strategy: Experiment phase (click letters, see word preview, clear and retry) followed by commitment phase (submit word for permanent removal)
• Permanent Consequences: Once you submit a word, those letters are gone forever, creating irreversible strategic decisions that reshape the entire game board

🏆 Competitive & Social Features:

• Intense 4-Minute Sessions: Fast-paced gameplay with automatic resets that keep the challenge fresh
• Global Reddit Leaderboards: Compete with players across all subreddits for the highest scores and most words found
• Real-Time Community Chat: Communicate with other players during gameplay for tips, encouragement, and friendly banter
• Live Community Progress: See total words discovered and recent finds by other players in real-time
• Achievement System: Track your progress with achievements for various milestones (currently being implemented)
• Native Reddit Integration: Seamless authentication, automatic post creation, and social sharing within the Reddit ecosystem

💎 Advanced Scoring & Validation:

• Comprehensive Word Validation: Server-side word validation against a curated English dictionary
• Progressive Scoring System: Points awarded based on word length and complexity
• Intelligent Letter Distribution: Weighted algorithm ensures balanced grids with optimal vowel/consonant ratios for maximum playability
• Comprehensive Word Recognition: Validates against a comprehensive English word database
• Anti-Duplicate System: Prevents submitting the same word twice in a single session

🎨 Immersive Visual Experience:

• Futuristic Space Theme: Stunning animated cosmic background with floating particles, geometric shapes, radial gradients, and sparkling star effects that create a mesmerizing gaming atmosphere
• Glassmorphism UI Design: Modern translucent cards with gradient borders, backdrop blur effects, depth layering, and sophisticated visual hierarchy
• Advanced Animation System: Neon hover effects with shimmer animations, 3D transforms, pulsing selection indicators, gradient shifts, victory confetti explosions, and smooth transitions
• Mobile-First Responsive Design: Optimized touch interactions with proper sizing, accessible controls, and seamless mobile Reddit experience across all device sizes
• Rich Visual Feedback: Real-time selection highlighting with numbered order badges, sparkle effects for removed letters, success celebrations, error animations, and dynamic progress indicators

• Devvit: Reddit's developer platform for immersive games
• React: Modern UI framework
• TypeScript: Type-safe development
• Express: Backend API server
• Redis: Data persistence and leaderboards
• Vite: Fast build tooling

Form valid English words by selecting letters from an 8×6 grid within intense 4-minute timed sessions. Master the unique "click-and-experiment" mechanic combined with strategic permanent removal to clear the entire grid while maximizing your score, competing on global leaderboards, and engaging with the Reddit community!

Word Deck is a fully functional multiplayer word game featuring:

• Dynamic letter grid with interactive letter cells that can be selected and removed
• Real-time word formation with visual selection feedback and numbered order indicators
• Comprehensive word validation with server-side dictionary checking
• 4-minute timed sessions with automatic game reset and countdown display
• Global leaderboard showing top 10 players with scores and statistics
• Real-time chat system for community interaction during gameplay
• Community progress tracking showing total words found and recent discoveries
• Responsive design optimized for both desktop and mobile Reddit users
• Achievement system (currently being implemented for future releases)

• Find a "🔤 Word Deck Challenge" post on Reddit
• Click the "🎮 Play Now" button on the splash screen to open the game in full screen mode
• You'll see a stunning futuristic space-themed interface with an 8×6 grid of 48 strategically distributed letters surrounded by animated cosmic effects
• A 4-minute countdown timer starts automatically when the game begins, displayed prominently with color-coded urgency indicators

🎮 Main Game Area:

• Letter Grid: Dynamic grid of interactive letter tiles with glassmorphism effects, neon hover animations, and 3D transforms
• Current Word Display: Shows the word you're building in real-time with cyan neon border, monospace font, and pulsing glow effects
• Word Controls: Submit (✓) and Clear (✗) buttons with gradient styling, hover animations, and disabled states for invalid actions

📊 Game Statistics Panel:

• Score: Your current points from found words with real-time updates
• Words Found: Total number of valid words discovered this session
• Progress: Letters removed vs. total letters showing completion percentage
• ⏰ Timer: Countdown showing minutes:seconds remaining with color-coded urgency

🌍 Community Features:

• Community Progress: Live tracking of total words found and scores across all active players
• Recent Discoveries: Real-time feed of latest words found by other players with usernames and timestamps
• Found Words Display: Your discovered words shown as colorful gradient chips with hover effects
• Leaderboard Toggle: View top 10 players with rankings, scores, and achievement badges
• Chat Toggle: Real-time messaging system with other players for tips and community building

Revolutionary Letter Selection Process:

1. Click any letter anywhere on the grid to start building a word (no adjacency rules or connection requirements!)
2. Letters are immediately selected and glow with neon cyan/magenta effects, showing their selection order numbers (1, 2, 3...)
3. Your current word appears in the glowing display area above the grid with real-time updates and pulsing animations
4. Continue clicking available letters to spell out complete words from anywhere on the grid - letters can be selected in any order from any position
5. Experiment freely: Selected letters remain on the grid until you submit the word, allowing you to see your word preview before committing
6. Strategic flexibility: Use the Clear button (✗) to restore all selected letters back to the grid and try different combinations without penalty

Advanced Visual Feedback:

• Selected letters pulse with neon cyan/magenta gradient effects and show numbered selection order badges in the corner
• Hover effects include shimmer animations, 3D transforms, scale effects, and smooth color transitions
• Current word display updates instantly with cyan highlighting, monospace font, letter spacing, and animated glow effects
• Successfully submitted words trigger celebration effects with sparkle animations (✨) and smooth letter removal transitions
• Invalid word submissions show clear error messages with helpful feedback, while successful submissions display point values

Submit Word (✓ Button):

• Validates your word against a comprehensive English dictionary
• Requires minimum 3 letters for valid submissions
• Awards points based on word length and complexity
• Permanently removes selected letters with celebration effects, confetti animations, and smooth transitions
• Shows detailed success message with points earned and adds word to your found words list
• Button is disabled until you have at least 3 letters selected

Clear Selection (✗ Button):

• Restoration mechanic: Instantly returns all currently selected letters back to their original grid positions with smooth animations
• Clears your current word display and resets all selection order numbers
• Allows unlimited experimentation with different word combinations before committing
• No penalty for clearing - encourages strategic thinking, optimization, and creative exploration
• Always available whenever you have selected letters, promoting risk-free experimentation

Comprehensive Word Validation System:

• Dictionary Validation: Server-side validation against a comprehensive English word database
• Invalid Words: Clear, helpful error messages explaining rejection reasons
• Duplicate Prevention: Cannot submit the same word twice within a single session
• Length Requirements: Minimum 3 letters, no maximum limit for creative long words

Point System:

• Word Length Based: Points awarded based on word length and complexity
• Progressive Scoring: Longer words typically earn more points
• Minimum Length: 3 letters required to score points

Real-Time Progress Tracking:

• Instant score updates with smooth animation effects and visual feedback
• Found words displayed as styled gradient chips below the grid with hover effects
• Dynamic progress indicator showing letters removed vs. total letters with percentage
• Automatic leaderboard updates when you achieve new personal best scores
• Achievement notifications for milestones, streaks, and special accomplishments

Intense 4-Minute Timed Sessions:

• Each game session lasts exactly 4 minutes for focused, high-intensity gameplay
• Timer displayed prominently with color-coded urgency (green → yellow → red)
• Countdown shows precise minutes:seconds format (e.g., "3:45", "0:30")
• Automatic reset when time expires, generating a fresh letter grid for new challenges

Strategic Time Management:

• Balance speed with strategic letter selection for optimal scoring
• Prioritize high-scoring premium words when time is running low
• Use Clear button strategically to experiment without time penalty
• Plan several moves ahead to maximize efficiency and point potential
• Monitor timer constantly and adjust strategy based on remaining time

Real-Time Chat System:

• Click "Show Chat 💬" to open the messaging interface with other active players
• Communicate during gameplay for tips, encouragement, and friendly competition
• Share strategies, celebrate discoveries, and build lasting community connections
• Messages limited to 200 characters with username display and precise timestamps
• Chat history preserved for the duration of your session

Global Leaderboard System:

• Click "Show Leaderboard" to view the top 10 players across all Reddit communities
• Rankings based on highest scores achieved, with ties broken by words found
• Displays username, best score, total words found, and last played date
• Medal emojis (🥇🥈🥉) for top 3 positions with special highlighting
• Your current session stats prominently highlighted for comparison

Community Progress Tracking:

• Live statistics showing total words found across all active players
• Real-time feed of recent word discoveries by other players with usernames
• Community-wide statistics and collective achievements
• Sense of participation in a larger, active gaming community
• Motivation through shared progress and friendly competition

Optimal Letter Selection Strategy:

• Start with common short words: CAT, DOG, SUN, BAT for quick, guaranteed points
• Plan letter usage meticulously: Once removed, letters are permanently gone
• Use challenging letters wisely: Incorporate Q, X, Z into longer, higher-value words
• Think multiple moves ahead: Consider how removing letters affects future word possibilities
• Preserve vowels strategically: Essential for most word formations, use sparingly

Scoring Optimization Techniques:

• Hunt for premium words: Prioritize 5-point words from the curated list for maximum efficiency
• Build longer words when possible: More letters often correlate with higher-value words
• Save vowels for critical moments: Essential letters that enable multiple word formations
• Experiment extensively with Clear button: Test different combinations before committing permanently
• Balance risk vs. reward: Sometimes safe short words are better than risky long attempts

Time Management Mastery:

• Quick wins first: Grab obvious short words early to build momentum and confidence
• Save complex words for mid-game: Work on longer words when you have sufficient time buffer
• Monitor timer constantly: Adjust strategy aggressively as time runs low
• Don't overthink simple decisions: Sometimes quick, intuitive choices are most effective
• Plan endgame strategy: Reserve easy letters for final seconds if needed

Multiple Victory Conditions:

• High Score Victory: Achieve your personal best score within the 4-minute limit
• Word Count Victory: Find more words than your previous best performance
• Community Victory: Contribute to community progress and shared achievements
• Complete Grid Clear: Remove all letters from the grid (extremely challenging)

Epic Completion Celebration:

• Spectacular victory screen with animated confetti effects and particle explosions
• Detailed display of final score, total words found, and any completion bonuses
• Complete chronological list of all words discovered during the victorious session
• Automatic leaderboard update if you achieved a new personal best score
• Achievement unlocks for various milestones and special accomplishments

Game Reset & Continuation Options:

• Manual Reset: Click "🔄 New Game" anytime for a fresh grid and new challenge
• Automatic Reset: Game automatically resets when 4-minute timer expires
• Fresh Challenge: Each reset provides completely new letter distribution and possibilities
• Session Continuity: Your achievements and leaderboard progress persist across sessions

Achievement Categories:

• 🏆 High Score Achievements: Unlock rewards for reaching score milestones (100, 150, 200+ points)
• 🎯 Game Completion: Special achievements for clearing the entire 48-letter grid
• 🔥 Word Streak: Recognition for finding multiple words in a single session (10+, 15+, 20+ words)
• 📅 Daily Challenge: Exclusive achievements for completing daily challenge posts
• ⭐ Milestone Rewards: Special recognition for joining elite scoring clubs and community contributions

Achievement Features:

• Persistent Progress: Achievements are saved to your Reddit profile and persist across sessions
• Visual Notifications: Unlock animations and celebration effects when earning new achievements
• Community Recognition: Share your achievements with the Reddit community
• Progress Tracking: View your complete achievement history and progress toward new goals
• Rarity Indicators: Different achievement types show their rarity and difficulty level

Building Your First Word (Step-by-Step):

1. Scan the grid for familiar letter combinations and common word patterns in the futuristic glowing interface
2. Spot C, A, T in different positions across the grid (letters can be anywhere - no adjacency required!)
3. Click C → Letter glows with cyan/magenta gradient and shows "1" badge, but remains on grid for now
4. Click A → Letter glows with neon effects and shows "2" badge, word preview updates
5. Click T → Letter glows and shows "3" badge, completing the word preview
6. "CAT" appears in Current Word display with cyan highlighting, monospace font, and pulsing glow effects
7. Click "✓ Submit Word" → Success! Letters are now permanently removed with sparkle effects, earn points based on word length
8. Celebration effects play: Success message appears, "CAT" is added to Found Words list as a green chip
9. Continue with remaining letters and build momentum for bigger words!

Using Strategic Clear Mechanic:

1. Start building "HOUSE" by clicking H-O-U-S in sequence, watching the neon word preview form
2. Realize better opportunity: Notice you could make "MOUSE" instead, or save letters for a longer word
3. Click "✗ Clear" → All selected letters instantly return to normal state with smooth animations, word preview clears
4. Build "MOUSE" instead by selecting M-O-U-S-E for potentially better scoring opportunity
5. No penalty incurred for clearing - encourages experimentation, strategic planning, and creative word discovery

Advanced Multi-Word Strategy Example:

• Identify high-value targets: Spot potential longer words for better scoring
• Plan optimal sequence: Determine which letters to use for maximum point efficiency
• Use common letters strategically: Distribute frequent letters across multiple words
• Save challenging letters: Reserve Q, X, Z for longer, higher-scoring word opportunities
• Monitor timer constantly: Adjust strategy based on remaining time and available opportunities
• Balance risk vs. certainty: Sometimes guaranteed short words beat risky long attempts

Make sure you have Node 22+ installed before running!

1. Find Word Deck posts on Reddit
2. Click "Launch App" to play instantly
3. No installation required!

1. Clone this repository
2. Run npm install to install dependencies
3. Run npm run dev to start development server
4. Follow the Devvit setup wizard to connect your Reddit account

• npm run dev: Starts development server with live Reddit integration
• npm run build: Builds client and server for production
• npm run deploy: Uploads new version to Reddit
• npm run launch: Publishes app for Reddit review
• npm run login: Authenticates CLI with Reddit
• npm run check: Runs type checking, linting, and formatting

• 8×6 Letter Grid: 48 strategically distributed letters with intelligent weighted vowel/consonant ratios for optimal playability
• Click-and-Experiment System: Revolutionary mechanic allowing free experimentation with neon visual feedback before permanent letter removal
• Dual Dictionary System: 300+ premium curated words (5 pts) + extended English dictionary (3 pts) for comprehensive word recognition
• 4-Minute Timed Sessions: Intense, focused gameplay with automatic resets and color-coded countdown timer
• Strategic Clear System: Risk-free experimentation with word combinations before permanent commitment
• Completion Bonus: Massive 100-point reward for the ultimate challenge of clearing the entire 48-letter grid

• Futuristic Space Theme: Stunning animated cosmic backgrounds with floating particles, geometric shapes, radial gradients, and sparkling star effects
• Glassmorphism UI: Modern translucent design with backdrop blur, depth layering, gradient borders, and sophisticated visual hierarchy
• Advanced Animations: Neon hover effects, 3D transforms, pulsing selections, gradient shifts, confetti celebrations, and buttery smooth transitions
• Mobile-First Responsive: Optimized touch interactions with proper sizing, accessible controls, and seamless mobile Reddit experience
• Rich Visual Feedback: Real-time selection highlighting, numbered order badges, sparkle effects, success celebrations, and dynamic progress indicators

• Global Leaderboard: Compete with top 10 players across all Reddit communities
• Real-Time Chat: Communicate with other players during gameplay with 200-character messages
• Community Progress: Live tracking of total words found and recent discoveries by other players
• Achievement System: Unlock achievements for high scores, game completion, word streaks, and milestones
• Reddit Integration: Native authentication, automatic post creation, and seamless social sharing

• Real-time Updates: Instant game state synchronization with Redis persistence and automatic recovery
• Achievement System: Comprehensive achievement tracking with persistent progress (currently being implemented)
• Community Features: Live chat system, communal progress tracking, recent word discoveries, and social interaction
• Advanced Animations: Confetti celebrations, particle effects, neon glows, 3D transforms, and smooth transitions
• Mobile Optimization: Touch-friendly interface with responsive design, proper touch targets, and accessibility features
• Type Safety: Full TypeScript implementation across client, server, and shared code with strict type checking
• Performance Optimized: Fast loading, smooth 60fps gameplay, efficient Redis caching, and optimized rendering
• Error Resilience: Graceful handling of network issues, automatic game state recovery, and user-friendly error messages

The game features a comprehensive word validation system:

• Curated Premium List: 300+ carefully selected common English words
• Extended Dictionary: Additional common English words for broader vocabulary recognition
• Smart Validation: Automatic detection of valid English word patterns

• Premium Words (curated list): 5 points each - includes common words like CAT, HOUSE, LETTER
• Standard English Words: 3 points each - valid English words not in the premium list
• Completion Bonus: 100 points for clearing the entire 48-letter grid
• Minimum Length: Words must be at least 3 letters to score

• 3-letter words: 80+ words (CAT, DOG, SUN, BAT, etc.)
• 4-letter words: 100+ words (WORD, GAME, PLAY, HAND, etc.)
• 5-letter words: 80+ words (HOUSE, DANCE, GRACE, PEACE, etc.)
• 6-letter words: 40+ words (LETTER, PUZZLE, CIRCLE, BOTTLE, etc.)
• 7+ letter words: Special longer words (TROUBLE, SPRINKLE, TWINKLE, etc.)

• React App: Modern component-based UI
• Game Logic: Letter grid management and user interactions
• API Integration: RESTful communication with server
• Responsive Design: Mobile-optimized CSS with Tailwind

• Express API: RESTful endpoints for game operations
• Redis Storage: Game state and leaderboard persistence
• Reddit Integration: User authentication and context
• Word Processing: Validation and scoring algorithms

• Type Definitions: Shared interfaces for type safety
• Word Lists: Curated English word database
• Game Logic: Scoring and validation utilities

Word Deck is designed for Reddit's platform:

1. Development: Test locally with npm run dev
2. Review: Submit with npm run launch
3. Publication: Automatic deployment after Reddit approval
4. Distribution: Available to all Reddit users instantly

Want to improve Word Deck? Contributions welcome!

• Add more words to the word list
• Improve scoring algorithms
• Enhance mobile experience
• Add new game modes
• Optimize performance

Built for Reddit's Devvit platform. See LICENSE file for details.