Changelog

Welcome to the MafiaDeck changelog. Here you'll find detailed information on the latest updates and enhancements. Check back regularly to stay informed about new features and improvements.

v0.9.7

• Link Previews
  • Share Card Added: Sharing a MafiaDeck link in iMessage, WhatsApp, Discord, Slack, or X now shows a proper preview card. Previously these links appeared as bare URLs with no image, title, or description.
• Accessibility
  • Zoom Restored on Web: Pinch zoom and double-tap to zoom now work on mafiadeck.com. Both had been disabled site-wide, which made the text difficult for anyone who needs to enlarge it. The mobile apps are unchanged.
• Discoverability
  • Findable in Search: The site now describes itself to search engines and AI assistants. It previously served no title or description at all, so there was nothing for a search result to show.
  • Pages Load Already Written: The landing, Privacy, Terms, and Changelog pages now arrive with their content in place rather than being assembled after loading, so they open faster and can be read by assistants that don't run scripts.

v0.9.6

• Performance: GPU-Accelerated Animations
  • App-Wide Upgrade: Animations throughout the app are now GPU-accelerated for significantly smoother rendering on all devices. This includes card reveals, carousels, vote stamps, elimination stamps, and Party Mode host panels.
  • Smoother Interactions: Proper layer promotion and compositing eliminate lag and stutter during animations, especially on lower-end devices.
• Reveal Card Animation Overhaul
  • Spring Physics: Card tilt now uses spring-based animation with natural overshoot and settle, replacing the old linear interpolation for a much more organic feel.
  • Dynamic Shadows: Card shadows now shift opposite to the tilt direction with role-specific glow colors (red for Mafia, blue for Detective, green for Doctor, etc.).
  • Gyroscope Tilt on Mobile: Revealed role cards subtly respond to your phone's orientation. Tilt your device and watch the card follow.
  • Touch Drag Tilt: On mobile, drag your finger across the revealed card to tilt it interactively.
  • Softer Haptic Flip: The haptic when flipping your role card has been softened from a strong buzz to a light tap for a less jarring feel.
• Carousel Overhaul
  • Active Card Depth Effect: Cards in the lobby and How to Play carousels now have a depth effect. The currently selected card appears at full size while surrounding cards scale down and fade, creating a layered "behind" feel.
  • Smooth Transitions: Card scaling and opacity animate fluidly as you swipe between cards.
  • Smoother Swiping: Major improvements to card swiping in the lobby and How to Play pages. Swiping between cards now feels significantly smoother with proper momentum and rubber-banding on all devices.
  • Better Touch Handling: Overhauled the underlying scroll and touch handling for a faster, more responsive experience across both iOS and Android.
• Party Mode Overhaul
  • Host-Triggered Voting: Party mode hosts can now trigger a vote at any time, and a runoff vote automatically starts when there's a tie. No more manual tie-breaking needed.
  • Automatic Elimination: When a vote ends, the loser is automatically eliminated, making vote counting effortless and keeping parties running smoothly.
  • Vote & Cancel: Players can now cancel their party vote and re-vote using the same footer button. It switches between VOTE and CANCEL depending on your current vote state.
  • Live Voter Display: Both the host panel and player carousel now show who voted for each candidate in real time, updating reactively as votes come in.
  • Host Panel Redesign: Restructured the host party vote panel for better vertical space usage and clarity. Progress bar now displays the vote count inline, buttons are on a single row, and the player list is scrollable for large games.
  • Game Stats Overhaul: Redesigned the Game Stats panel with cleaner, more consistent section styling. Win probability now uses an improved calculation that better reflects actual game dynamics. Added descriptive subtitles and alive/total counts for clearer at-a-glance information. The Jester role is now represented as an Independent faction in both Setup Balance and Win Probability, with its own bar segment and stats row.
  • Game Log Improvements: Reformatted log entries with a cleaner layout. Icon, title, and timestamp are now in a single header row with details below. Elimination and revive entries now show the player's role. Scroll bars no longer overlap content.
  • Reworked Host Tutorial: The party mode host tutorial has been completely reworked to be clearer, more intuitive, and snappier for new hosts, with more detailed instructions and smoother animations.
  • Visual Refinements: Improved visual continuity throughout the Party Mode host view. Fixed various visual glitches, sizing issues, and sticky hover states on mobile. Scroll bars now appear smoother and more polished.
  • Voting UI Polish: Improved styling and responsiveness across the voting interface. Consistent button sizing, fixed layout shifts when switching between vote states, and better spacing on mobile.
• Settings Panel Overhaul
  • Slide-In Animation: The settings panel now slides smoothly in and out with a matching overlay fade transition. Added a minimize button in the panel header for quick dismissal.
  • Redesigned Tabs: Redesigned the tab switcher as a segmented control with a shared background container. Renamed the redundant "Settings" tab to "General".
  • Socials & Credits: Added a socials section at the bottom with links to Discord, Instagram, X, and LinkedIn, along with a "MafiaDeck by Rawi Studios" credit.
  • Quality of Life: Added a "Returns all players to the lobby" hint inside the Return to Lobby button. Haptic feedback now triggers when opening the settings panel.
• How to Play Refresh
  • Reordered Tutorial Flow: Cards now follow a more logical progression: Game Concept, Core Roles, Game Flow, Victory Conditions, Game Modes, then Customization.
  • Updated Content: Refreshed tutorial card content to better reflect the current game experience, including unlockable roles and avatars.
• Lobby Share Card Improvements
  • Haptic Feedback: Tapping the game code to copy, expanding the QR code, and collapsing back now all trigger haptic feedback on supported devices.
  • QR Code Tap to Dismiss: Tapping the expanded QR code now flips the card back to the share view. No need to find the back button.
• Bug Fixes
  • iOS Party Mode Scrolling: Fixed an issue on iOS where the stats and log sections in Party Mode were not scrollable, unlike Android and web.
  • Android Audio Overhaul: Completely overhauled the audio system on Android devices. Fixed issues where music tracks would not play or layer on top of each other.
  • Mobile Audio Toggle: Removed the hover lift effect on the mute button in the main menu on mobile devices.
  • Toast Notification Position: Fixed toast notifications (e.g., QR scan errors) appearing too low on the main menu screen.
  • Settings Button Safe Area: Fixed the settings button in the game header getting clipped by iPhone curved edges. Now properly respects the device safe area.
  • Android Status Bar Overlap: Fixed the Terms, Privacy, and Changelog page titles appearing behind the Android status bar, making it impossible to navigate back.
  • Deep Linking Fix: Fixed deep links not working on iOS and Android by adding the required asset association files for both platforms.
  • Party Vote Settings Access: Fixed an issue where the settings button was not visible for players during a party vote in Party Mode.
  • Party Vote State Fix: Fixed an issue where party votes could remain active between games when returning to the lobby, causing the vote panel to persist into the next game.

v0.9.5

• New Role: The Jester
  • Chaotic Wildcard: The Jester is a new independent role whose sole goal is to get voted out by the town during the day. If the Jester is eliminated by day voting, they win alongside the main game's winner!
  • Night Action - Impersonate: Each night, the Jester can choose to impersonate another player. If a Detective investigates the Jester that night, they'll see the impersonated player's role instead of "Jester".
  • Strategic Deception: Jesters can bluff their way to victory by appearing suspicious enough to get voted out, but not so suspicious that they're ignored. Picking the right player to impersonate can make a Detective think you're Mafia!
  • Detective Exposure: If a Jester doesn't use their impersonate ability and gets investigated, the Detective will see "CHAOTIC - They are the Jester!" - blowing their cover entirely.
  • Unlockable Card: The Jester role card can be unlocked in the Scrapbook after winning 5 games.
  • Party Mode Support: Hosts can manually assign the Jester role in Party Mode for custom game setups.
• Lobby Configuration Revamp
  • Streamlined Custom Settings: Renamed "Configuration" to "Custom" and moved the navigation for a more intuitive flow.
  • Role Balance Indicator: Added a visual indicator showing role counts by faction (e.g., "2 Mafia, 3 Town, 1 Independent") to help hosts quickly gauge game balance.
  • Enhanced Timer Controls: Reorganized phase timers (Day, Night, Results) into a clean, row-based layout with clear unit labels for easier adjustment.
  • Polished UI: Updated text colors to parchment tones, refined input styling, and added smooth animations for a more premium feel.
  • Results Duration: Added a new setting to control the duration of the results phase.
• Touch Interaction Improvements
  • No More Double-Taps: Fixed an issue where hover effects on cards (Voting, Roles, Polaroids) required two taps to interact on mobile devices. Interactions are now instant and responsive.
  • Cleaner Mobile Lobby: Hidden icon hover labels in the main lobby menu on native platforms to prevent unwanted tooltips during touch interactions.
• Immersive Landing Page Refresh
  • Unified Atmospheric Experience: Applied a fixed, continuous cinematic gradient background across the entire landing page for a seamless and immersive storytelling feel.
  • Party Mode Demo Fix: Corrected the layering of the radar animation in the Party Mode showcase to ensure signal waves ripple behind the host device.
  • Visual Game Modes: Replaced technical mode descriptions with dynamic visual diagrams for Party and Classic modes, showcasing the platform's versatility at a glance.
  • Centered Cinematic Hero: Restructured the hero section with a centered, staggered brand logo and punchy, high-impact copy to immediately capture the game's essence.
  • Professional Iconography: Replaced all emojis with high-quality, professional vector icons throughout the platform's feature showcases.
  • Optimized Action Flow: Integrated the "How to Play" guide directly into the hero section and refined the "Play Now" button with high-visibility gold gradients and pulsing animations.
  • Streamlined Community Integration: Redesigned the community and newsletter signup area with a modern, integrated input layout and cleaner secondary actions.
• Collection & Avatar Updates
  • Avatar Art Refresh: Adjusted artwork colors for The Shade, The Black Widow, and The Harlequin uncommon avatars. Removed green hues and refined color palettes for a more cohesive look.
  • Responsive Unlock Screen: The avatar unlock screen is now more responsive across different device sizes and can be closed by tapping anywhere outside the modal.
  • Scrapbook Polish: Enhanced styling and animations throughout the scrapbook for a more polished experience.
  • Centered Sign-In Prompt: The sign-in prompt for anonymous users is now vertically centered for better visual balance.
  • Unified Rarity Colors: Avatar and Role Card rarities now share a consistent color scheme (Common: Brass, Uncommon: Green, Rare: Blue, Epic: Purple, Legendary: Gold) for visual consistency across the collection.
• Share Card Flip Animation
  • Immersive QR Expansion: Clicking the QR code in the Share card now flips the card to reveal an expanded view, replacing the previous modal popup for a more integrated and tactile experience.
• Profile Page Redesign
  • Organized Sections: Restructured the profile page into "Default Profile" and "Account Information" sections for clearer navigation.
  • Read-Only Display: The profile section now shows your default name and avatar. To edit your profile, visit your Scrapbook.
  • Streamlined Sign-In: Refined the sign-in flow with improved button styling and visual consistency.
  • Safer Account Deletion: Replaced double-click confirmation with a modal requiring users to type "delete" for added safety.
• Bug Fixes & Polish
  • Unified Game Logic: Consolidated game configuration across frontend and backend into a single source of truth. This eliminates inconsistencies, prevents maintenance bugs, and makes future updates faster to implement.
  • XP System Improvements: Fixed issues where XP would sometimes fail to save properly, especially on mobile devices. Improved XP calculation and assignment speed at game end.
  • Avatar Selection Fix: Fixed a bug where selecting uncommon avatars (The Black Widow, The Harlequin, The Shade) in the lobby would default to a different avatar when the game started. All 21 avatars now work correctly.
  • Bot Avatar Diversity: Improved bot avatar assignment to maximize variety. Bots now cycle through all avatars before repeating, ensuring every character appears before duplicates occur.
  • Reveal Card 3D Effect: Fixed the 3D hover effect on role cards during the reveal phase. The tilt now responds intuitively regardless of whether the card is face-up or face-down.
  • Persona Card Keyboard: Fixed an issue on mobile where editing your name would shift content unevenly. Now the entire card content shifts together.
  • End Game Results Polish: Improved the look and feel of the end game results screen.
  • New Game Transition Fix: Fixed a game-breaking bug where if a new game took too long to load, the end game results screen would briefly preview the roles and information of the next round. This could allow observant players to see upcoming roles for a split second before the transition completed.
• Unified Header & Footer Redesign
  • Consistent UI Across All Modes: Completely redesigned the game header to be consistent across Classic Mode, Party Mode, and all game phases. No more visual variations between different views.
  • Sleek Vertical Timer Stack: The new header features a compact vertical layout with the phase indicator on top (small), timer in the middle (large), and vote count on the bottom (small) - all in one unified glassmorphic container.
  • Clean Timer Display: Removed the clock icon for a cleaner look. Timer now shows with leading zeros (00:00 format) and maintains a fixed width to prevent layout shifts.
  • Smooth Animations: Added subtle fade animations when the vote count appears/disappears and when switching between phases for a more polished feel.
  • Unified Settings Button Style: All settings buttons across the app now share the same rectangular glassmorphic style for visual consistency.
  • Settings Panel Z-Index Fix: Fixed an issue where the settings panel would sometimes appear behind the game footer. The panel now always displays above all other UI elements.
• Party Mode Enhancements
  • Host-Triggered Voting: Party mode hosts can now trigger a vote at any time, and a runoff vote automatically starts when there's a tie - no more manual tie-breaking needed.
  • Automatic Elimination: When a vote ends, the loser is automatically eliminated, making vote counting effortless and keeping parties running smoothly.
  • Reworked Host Tutorial: The party mode host tutorial has been completely reworked to be clearer, more intuitive, and snappier for new hosts - with more detailed instructions and smoother animations.
  • Stability Improvements: Refined party mode with numerous bug fixes throughout for smoother gameplay.
• Additional Improvements
  • Role Dossier Scroll Fix: Fixed an issue where the role dossier (briefing screen) was not easily scrollable on small devices. The dossier now scrolls smoothly with vertical-only scrolling.
  • Cleaner Error Messages: Replaced inline error messages with clean toast notifications that appear at the top of the screen for a more polished experience.
  • Overall Polish: Many bug fixes, tweaks, and refinements throughout the entire app.

v0.9.4

• Doctor Role Enhancements
  • Self-Protection: Doctors can now protect themselves during the night phase, adding a new layer of strategic depth.
  • Cooldown Mechanic: To balance self-protection, doctors cannot protect the same player two nights in a row. This prevents infinite self-healing loops and encourages strategic target selection.
  • Visual Cooldown Indicator: Players on cooldown appear greyed out with their role card visible and a "PROTECTED LAST NIGHT" label, making it clear who cannot be selected.
• Improved Small Game Balance
  • Detective at 4 Players: Lowered the detective role threshold from 5 to 4 players. 4-player games now feature 1 Mafia, 1 Detective, and 2 Civilians instead of just 1 Mafia and 3 Civilians.
  • Doctor Remains at 5+: The doctor role still requires 5+ players to prevent overpowered healing in small games where the probability of saving the target is too high.
• End Game Results Visual Refresh
  • Newspaper-Style Layout: Complete redesign of the end game results screen with a staggered newspaper article layout. Player blurbs now appear as articles to the left and right of polaroids, creating an authentic newspaper aesthetic.
  • Enhanced Player Storytelling: Each player now receives a witty, role-specific blurb with structured status fields (WINNER/LOSER/JESTER • ALIVE/DECEASED) that reads like a newspaper profile.
  • Consistent Storytelling: Headlines, newspaper names, and victory messages are now generated once by the host and shared across all players, ensuring everyone sees the same narrative.
  • Role-Aware Blurbs: Unique humorous descriptions for each role and outcome (dead doctor, eliminated detective, caught mafia, innocent civilian, jester victories) that capture the story of each player's game.
• Enhanced Gameplay Experience
  • Spectator Overhaul: Spectators can now freely navigate the player carousel with full arrow controls and clear status indicators, making it easier to follow the action from beyond the grave.
  • Immersive Mafia Teammates: Mafia members now see their teammates with revealed role cards tucked behind their polaroids - matching the spectator view aesthetic - instead of the previous red border style.
  • Context-Aware Actions: The main action button now intelligently switches between "VOTE" (during the day) and "ACT" (during the night) to better reflect your current role's capabilities. Voting controls are now reliably available throughout the entire day and voting phases.
  • Polished UI Transitions: Added smooth fade-in effects for spectator and game interfaces, ensuring every screen transition feels seamless and intentional.
• Lobby UX Enhancements
  • Easy Exit: Added a prominent back button to the first card ("Share") in the lobby, making it much easier to leave the lobby without navigating menus.
  • Layout Fixes: Fixed a layout shift issue in the player list where the scrollbar would cause content to jump. The layout now remains stable regardless of list length.
  • Smart Scrolling: The "Add Bot" button now automatically stays in view when adding bots, scrolling the list to the bottom instantly so you can add multiple bots quickly without manual scrolling.
• Cinematic Reveal Experience
  • Brand New Reveal Animations: Completely reimagined reveal phase with dramatic new text animations and visual effects that build suspense before showing your role.
  • Interactive Dossier: New "Mission Briefing" dossier provides a thematic and immersive way to learn your role. Includes your personalized character polaroid, clear objectives, and strategic intel before the game begins.
  • Refined Reveal Phase: Completely overhauled the Classic Mode reveal phase. Now features a 10-second auto-start timer, clickable card to hide/reveal role, and a "View Dossier" button to access mission details at any time.
  • Enhanced Role Descriptions: Updated role descriptions to be more thematic and instructive, helping new players understand their purpose immediately.
  • Party Mode Dossier: The immersive Mission Briefing dossier is now available in Party Mode! Players can access detailed role information and strategic intel to better understand their specific objectives.
• Immersive Audio Overhaul
  • Rich Soundscape: Added a vast library of new high-quality sound effects across Classic Mode. Every interaction - from card flips to phase changes - now has distinct, satisfying audio feedback.
  • Dynamic Music System: Background music now features 4 new smooth jazz tracks that shuffle seamlessly throughout gameplay phases (Reveal → Day → Night), creating a continuous and immersive cinematic score.
  • Smart Shuffle: Music tracks now shuffle intelligently without repetition, ensuring a fresh audio experience throughout long sessions.
• Visual Polish
  • Cinematic Interface Loading: Implemented a new staggered loading sequence for the game interface. The pinboard, player polaroids, role cards, and UI controls now deal in sequentially for a more immersive "setup" feel.
  • Uniform Gradients: Standardized role card backs to use the Civilian accent and uniform red gradient for all roles (Mafia, Doctor, Detective) to prevent role identification from the card back.
  • Night Results Redesign: Enhanced the Night Results screen with a unified red/black gradient theme for both public and private cards. Replaced the moon icon on the Private Intel card with a flickering candle animation and updated the lock icon to a fingerprint for a more thematic "secret dossier" aesthetic. Removed redundant "Public" and "Private" badges for a cleaner look.
  • New Card Dealing Animations: Smooth, realistic card dealing animations during the setup phase that make the digital tabletop feel more tactile and grounded.
  • Polaroid Integration: Your chosen character avatar is now featured directly in your mission dossier, reinforcing your in-game identity from the start.
• Classic Mode Behavioral Changes
  • Tie-Breaker Logic Update: Tie votes now result in a random elimination among the tied players instead of defaulting to "no elimination". This prevents game stalemates and keeps the action moving forward.
  • Smart Bot Herd Behavior: Bots now prioritize voting for targets that real players have already voted for. This simulates realistic "herd behavior" and amplifies human decisions, making bots feel more like teammates and less like chaos agents.
• Bug Fixes & Stability
  • Mafia Identification Fix: Resolved a critical issue in Classic Mode where Mafia members couldn't correctly identify their teammates, sometimes leading to accidental friendly fire. Teammates are now clearly marked, preventing invalid voting targets.
  • Restored Voting Controls: Fixed a critical issue where voting arrows and buttons would disappear during the day phase if the server used specific phase naming conventions.
  • Layout Fixes: Resolved layout scrolling issues in spectator and role interfaces that caused unwanted double scrollbars.
  • Footer Interactivity: Fixed z-index layering issues that could cause the game footer (and vote button) to become unclickable or invisible in certain states.
  • Clean Status Display: Phase status icons no longer incorrectly display during "waiting" states, reducing visual clutter.
  • Stability Improvements: Fixed a syntax error in the Reveal Phase component and improved general stability during phase transitions.
  • Party Mode Centering: Fixed alignment issues in the Party Mode carousel where selected cards weren't perfectly centered on some devices.
  • Host Stats Polish: Refined the Game Stats card in Host View - removed redundant minimize button and round indicator for a cleaner look, and improved scrollbar styling on desktop.

v0.9.3

• Major Voting System Overhaul - Critical Stability Fix
  • Major Stability Improvements: Complete migration to round-based vote storage with isolated subcollections for dramatically improved reliability and performance
  • Fixed Vote Contamination: Eliminated duplicate vote issues and vote persistence bugs between rounds - each round's votes are completely isolated
  • Faster Response Times: Votes now process instantly with optimized database queries and reduced latency
  • Enhanced Bot Intelligence: Smarter bot voting with improved suspicion tracking and more realistic decision-making patterns
  • Better Visual Feedback: Vote buttons now show dynamic text ("Vote", "Voting...", "Voted") instead of just check marks for clearer player feedback
  • Accurate Vote Counting: Fixed vote counting inconsistencies during phase transitions with improved real-time synchronization
• Civilian Role Expansion
  • New Peek Ability: Civilians can now peek at one player's voting habits during night phase - adds strategic depth to non-power roles
  • Enhanced Role Reveal: Day phase results now show which civilians used their peek ability and who they investigated
  • Information Sharing: Peek results create opportunities for civilians to coordinate and share intelligence during day discussions
• Storytelling Content Expansion
  • 15+ Unique Variations: Massive expansion of storytelling content for day and night elimination scenarios
  • Personality-Driven Narratives: Each bot personality now has distinct storytelling styles with unique humor and wit
• Seamless Round Continuation
  • Quick Restart: Hosts can now start a new round directly from the end game results screen without returning to lobby
  • Preserved Settings: All game settings and player roster carry over to the new round automatically
  • Streamlined Experience: Skip the lobby setup entirely and jump straight into the next game
• Redesigned Profile System
  • Unified profile section with smoother design and better visual consistency
  • Set your avatar and display name in the Profile page - automatically applied when creating or joining games
  • Lobby changes (avatar/name) are now session-only - permanent changes only happen from the Profile page
  • When returning to lobby after a game, your previous game avatar is preserved
  • Profile data synced to Firestore for authenticated users, with localStorage backup
  • Clearer "Delete Account" button that always shows text, not just on confirmation
• Refined Animations & Transitions
  • Improved animation speed and fluidity across all pages for a more responsive feel
  • Enhanced lobby card carousel with faster, snappier transitions when navigating between sections
  • Smoother How to Play tutorial animations with improved card closing effects
  • Polished navigation elements with cleaner fade-out effects when leaving pages
• Enhanced Audio System
  • Improved iOS audio performance with better battery life
  • Fixed volume controls - 0% is now completely silent
  • Smooth audio transitions without interruptions
  • Added 12 new sound effects throughout the app and gameplay to improve immersion and player feedback
  • New sound effect plays when How to Play tutorial cards collapse
• Complete Scrapbook Collection
  • 4 Tabs: Stats, Avatars, Role Cards, and Achievements
  • Stats Tab: Track your performance with game counts, win rates, streaks, role statistics, and recent activity
  • Avatars Tab: Browse all 21 character avatars with flip animations and character bios. Progressive unlock system (7 start unlocked, 14 to unlock)
  • Cards Tab: Collect 4 base role cards (Civilian, Mafia, Doctor, Detective) with dramatic reveal card styling
  • Achievements Tab: Track 20 achievements across collection, gameplay, performance, role mastery, and hosting categories
  • Sound Effects: Book slam on open, pickup on close, page flip between tabs, camera click when browsing
  • Seamless Navigation: Tab switching with page-flip animations, all content properly scrollable
• Enhanced How to Play Tutorial
  • Added new Game Modes card explaining Classic Mode vs Party Mode differences
  • Smooth card-dealing entrance animation when opening the app for the first time
  • Improved card carousel with cleaner sliding animations between tutorial cards
  • Fixed fan-out animation for smoother, sleeker card transitions
  • All 7 tutorial cards now properly navigate with touch swipes and arrow keys
  • Mobile Improvements: Removed arrow buttons on mobile in favor of intuitive swipe navigation with progress dot indicators that fade in/out
• UI/UX Polish
  • Smooth avatar carousel with left/right arrows and wrap-around navigation
  • Progress bar loading indicators replace spinning icons throughout app
  • Platform-aware navigation (native apps return to right page, web to homepage)
  • Consistent icon button sizing across all interfaces
  • Music plays continuously when navigating between pages
• Classic Mode Improvements & Polish
  • Improved Layout: Enhanced spacing of pinboard and carousel to match Party Mode's smoother aesthetic for a better player experience
  • Carousel Enhancements: Refined avatar polaroid animations and transitions throughout Classic Mode gameplay
  • AI Personality System: Major improvements to AI bot behavior with distinct personalities for each character
    • Each AI now has unique personality types that influence their gameplay decisions and communication style
    • Typewriter effect replaces thought bubbles - bots now "type" messages with timing that reflects their personality
    • Typing speed and patterns correspond to both personality type and current role in the game
    • Players can deduce character traits and potentially identify roles by observing typing behaviors
    • Creates a more dynamic and engaging experience when playing with AI opponents
• Enhanced Analytics
  • Party Mode session tracking with cumulative playtime across multiple games
  • Host UID tracking in notifications for better analytics
• Bug Fixes & Polish
  • Major focus on sound effects polish across all interactions
  • Refined animations throughout the app for smoother, more polished feel
  • Fixed Sass deprecation warnings for future compatibility
  • Fixed stats level displaying as 0 on first load when signed in - now properly waits for Firestore data
  • Avatar cycling in lobby now correctly restricted to only unlocked avatars
  • Random avatar selection ("Undecided") now only chooses from user's unlocked avatars
  • Bot avatars now use any avatar as a "sneak peek" feature to encourage unlocking
  • Bots now strongly prefer unique avatars - duplicates only occur when all 21 avatars are in use
  • General bug fixes and performance improvements

v0.9.2

• 📸 Scan to Join Games!
  • QR Code Scanner: You can now scan QR codes directly in the mobile app to join games instantly - no more typing game codes or having to open your camera app!
  • Smart Detection: The scanner automatically recognizes MafiaDeck QR codes and joins the game for you.
• Lobby Page Styling Updates
  • Cleaner Card Design: Removed distracting hover effects from all lobby cards (Game Info, Persona, Players, Settings, Actions) for a cleaner, more focused interface.
  • Numbered Step System Restored: Brought back numbered badges (1-5) next to each card title to help guide players through the lobby setup process. Each badge features a polished brass gradient design with subtle shadows.
  • Subtle QR Code Icon: Reduced the white glow effect around the QR code logo for a cleaner, more refined appearance. The glow is now approximately 70% less intense while maintaining sufficient contrast for visibility.
  • Game Mode Details: Added informative context badges to game presets showing "Great for online play" (Classic Mode) and "Great for in-person play" (Party Mode). Both modes now support 4-12 players for consistent group sizes.
• Enhanced Non-Host Lobby Settings
  • Slider-Based Audio Controls: Settings tab now features professional volume sliders for Master, Music, and Sound Effects with individual mute toggles and percentage displays. Clean circular mute buttons change from brass to red when muted.
  • Vibration Toggle: Native mobile platforms now have a dedicated vibration control with enable/disable button (automatically hidden on web).
  • Instant Tab Switching: Removed fade transitions between tabs (Persona, Share, Players, Settings) for snappier, more responsive navigation.
  • Hidden Ready Button in Settings: Ready Up button now intelligently hides when viewing the Settings tab to prevent clutter and give more space for controls.
  • Scrollable Settings: Settings tab content now scrolls smoothly if controls exceed available height, ensuring all options remain accessible.
• Smarter Name Editing
  • Automatic Saving: Your name now saves automatically after you stop typing - no more clicking save buttons!
  • Visual Feedback: See helpful status messages like "Typing...", "Saving...", and "Saved!" so you always know what's happening.
  • Works Everywhere: This improved editing experience is now consistent for everyone in the lobby.
• Mobile Name Editing Improvements
  • Smooth Keyboard Slide-Up: On mobile, editing your name now smoothly slides the content up to reveal the input above the keyboard - no more keyboard blocking your typing! Content slides back down after editing completes.
  • Content Clipping: Avatar section that slides above the tab switchers is elegantly hidden, maintaining a clean interface during name editing.
• 📳 Enhanced Haptic Feedback - Lobby!
  • Ready Status Confirmation: Minor haptic feedback now triggers when you successfully toggle your ready status in the lobby.
  • Name Save Confirmation: Feel a subtle haptic tap when your name is successfully saved, providing tactile feedback that the action completed.
  • Start Game Confirmation: Major haptic feedback now triggers when the host presses "Start Game", providing strong tactile confirmation that the game is beginning.
• Party Mode Host Interface Improvements
  • Circular Host Avatar: Host's avatar now displays as an elegant circular design (replacing the polaroid card), making it clearer that the host is the game master, not a player. Features a subtle floating animation and golden crown icon.
  • Loading Indicators: Host now sees clear feedback when shuffling roles, revealing roles, changing player roles, eliminating/reviving players, and declaring winners. A status bar shows what's happening, and success notifications confirm when actions complete.
  • Helpful Prompts: After shuffling roles, the host sees a notification reminding them to reveal roles to players - perfect for first-time hosts!
  • Snappier Carousel: Player card carousel now features significantly faster transitions with much smoother animations - navigating between players in Party Mode feels incredibly responsive and polished.
  • Smooth Touch Gestures: Improved swipe controls for carousel - cards now follow your finger in real-time as you drag, with a larger touch area for easier navigation. Fixed rapid-tap support for arrow buttons.
  • Smoother Animations: Fixed layout shift when toggling the timer play/pause button, improved toast notification transitions, and smoother tutorial fade-in.
  • Better Card Selection: Selected player cards no longer scale up on mobile, reducing visual clutter and making the interface cleaner.
  • Tutorial Enhancements: Host tutorial now appears above all notifications, won't repeat after being completed or skipped, and works properly in party mode with anonymous users.
  • Redesigned Phase Guide: Completely overhauled the host's guide (formerly "Cue Cards") with a simpler, more practical 4-step playbook. Removed theatrical scripting and drama coaching in favor of clear, actionable instructions. Now includes explicit menu references (Player menu for eliminations, Game menu to declare winner) and explains that declaring a winner reveals all roles to everyone.
  • Safer Mid-Game Shuffling: Shuffling roles after they've been revealed now requires double-click confirmation to prevent accidental disruption during an active game.
  • Better Mobile Menu Positioning: Game and Player dropdown menus on mobile now appear directly above their respective buttons (left and right sides) instead of centered, making it clearer which button opened which menu.
  • iOS Notch/Dynamic Island Fix: Fixed issue where timer would appear behind the iPhone notch or Dynamic Island on first app launch.
  • Bot Icon Fix: Bots now correctly display robot icons instead of connection status icons in the Players panel.
  • Comprehensive Haptic Feedback: Added tactile feedback throughout the host interface - minor haptics for menu toggles and navigation, medium haptics for confirmations and timer controls, success haptics for completed actions, major haptics for game-changing events (shuffle, reveal, declare winner), and error haptics for failed operations. Creates a professional, responsive feel that matches the visual polish.
  • Two-Bar Balance System: Game Stats card now shows two separate balance indicators - "Setup Balance" (static, shows if initial role distribution was fair) and "Win Probability" (dynamic, factors in alive players and power roles like Detective/Doctor). Each bar has distinct styling and status indicators for at-a-glance game state assessment.
  • iOS Card Scrolling Fix: Fixed critical issue where Game Stats and Game Log info cards weren't scrollable on iOS devices. Both cards now feature smooth momentum scrolling with proper touch handling.
  • Settings Panel Consistency: Unified all toggle button styling (vibration and audio controls) to use consistent white theme instead of mixed golden/white colors, creating a more cohesive settings interface across the app.
  • New Iconography: Added custom SVG icons for the Game Stats and Game Log info cards on the back side - features elegant notebook and document illustrations that match the game's vintage aesthetic.
• 📳 Immersive Vibration Feedback!
  • Feel the Game: Your device now vibrates at key moments - when you see your role, someone is eliminated, the game ends, you cast a vote, and when phases change. Makes party mode feel more alive!
  • Customizable: Toggle vibration feedback on or off in Settings (mobile only).
  • Smart Timing: Different vibration strengths for different events - strong for eliminations, medium for votes, creating a layered feedback experience.
• Party Mode Timer Fixes
  • Timer Now Works in Background: Fixed an issue on some devices where the host timer might stop when the app was minimized or the screen was locked. The timer now continues running accurately in the background.
  • Timer Alarm: When the timer completes, your device will vibrate and play a sound whether the app is minimized, the screen is off, or you're actively in the app.
• App Startup Improvements
  • Faster Load Times: The app now starts up much faster across all devices with optimized initialization and resource loading.
  • Cleaner Launch: Fixed an issue on some devices where the landing page would briefly flash before opening the game screen. The app now starts smoothly every time.
  • Better Timing: The splash screen now waits for everything to load properly before disappearing.
• How to Play Mobile Improvements
  • Snappier Card Switching: Swiping between tutorial cards is now much faster and more responsive.
  • Improved Scrolling: Fixed an issue on mobile where some users couldn't scroll through longer tutorial content. You can now easily scroll up and down to see all the content while still being able to swipe left and right between cards.
  • Smarter Touch Handling: The app now better understands whether you want to scroll or swipe, making navigation feel natural and intuitive.
• Universal Loading Indicators
  • Consistent Feedback Everywhere: Implemented a new universal loading indicator system throughout the app. Buttons and UI components now show clear visual feedback when processing actions - from joining games and saving names to toggling settings and ready status. You'll always know when something is loading!
• Keyboard & Input Improvements!
  • Easier Keyboard Dismissal: The native iOS keyboard now shows a "Done" button, making it easy to dismiss the keyboard when editing names or entering game codes.
  • Better QR Code Visibility: Added a subtle "Click to expand" hint below QR codes so you know they're tappable for a larger view.
• Foundation for Future Content
  • Groundwork in Progress: We've begun laying the groundwork for exciting new content additions including fresh sound effects, enhanced graphics, and new character avatars. Stay tuned for these enhancements in upcoming releases!

v0.9.1.1 (Hotfix)

• Bug Fixes
  • How to Play Mobile Centering: Fixed an issue where swipe gesture navigation on the How to Play page would cause content to go off-screen on mobile devices. Cards now stay properly centered when swiping through tutorial content.
  • Page Scrolling Navigation Fix: Resolved scrolling issues when navigating between landing page, Privacy Policy, and Terms of Service pages. All pages now scroll properly regardless of navigation direction.
  • Mobile Button Drag Prevention: Disabled drag functionality on social media icons and links in the About section on mobile devices, preventing unintended drag interactions on iOS.
• Landing Page Refinements
  • Party Mode Subtitle Optimization: Shortened and improved Party Mode description to fit cleanly on one line across all devices.
  • Mode Comparison Alignment: Updated Party Mode and Classic Mode bullet points to align better for side-by-side comparison, making it easier to understand the differences.
  • No Physical Cards Banner Redesign: Redesigned the "No Physical Cards Required" section with glassmorphic styling to better match the landing page aesthetic. Banner is now more subtle and properly positioned.
  • Development Progress Badge Consistency: Fixed inconsistent status text across progress badges ("Complete" vs "Completed") for a more polished appearance.

v0.9.1

• Enhanced Card Expansion System!
  • Fullscreen Card View: Role cards and info cards now expand to beautiful fullscreen views when tapped, letting you see all the details with gorgeous animations.
  • Flip Animations: Info cards now flip smoothly before expanding, matching the polished party mode experience.
  • Enhanced Info Card Design: Info cards now display with decorative headers, numbered rules with gold badges, and polished typography for better readability.
• Voting Interface Improvements
  • Fixed Card Glow Clipping: The golden glow effect on selected voting cards is no longer cut off by container boundaries - it now shines beautifully across all devices.
  • Removed Vertical Movement on Hover: Selected voting cards now scale smoothly without jumping upward, creating a more polished hover effect.
  • Better Mobile Spacing: Player info panel on mobile now has proper spacing to prevent footer buttons from blocking cards.
  • Stable Card Layout: When expanding cards, the other cards maintain their positions with invisible placeholders - no more layout shifting!
• Polish & User Experience
  • Centered Card Expansion: All expanded cards are now perfectly centered on screen with proper responsive sizing for desktop and mobile.
  • Optimized Padding: Reduced padding throughout card interfaces for better content density and cleaner appearance.
  • Touch Event Improvements: Added proper touch event handling for mobile devices with tap highlight removal for a native app feel.
  • Click/Tap Outside to Close: Tap anywhere outside an expanded card to quickly minimize it - works perfectly on both desktop and mobile.
  • Elegant Minimize Button: Cards feature a clean minimize button positioned below the card for easy dismissal.
  • Premium Legal Pages Redesign: Completely modernized the Privacy Policy, Terms of Service, and Changelog pages with a clean, sophisticated design featuring glassmorphic styling, improved typography, and better readability. Removed busy background elements for a more professional, premium feel.
  • Swipe Navigation for How to Play: Added swipe gesture support to navigate through How to Play cards on mobile devices. Swipe left/right to quickly browse through tutorial cards with smooth, snappy animations.
  • Minor Avatar Tweaks: Updated the Widow avatar (#12) with subtle visual refinements for improved consistency.
• Bug Fixes
  • Fixed Keyboard Blocking Input: Resolved an issue where the on-screen keyboard would block the name input field when joining games on mobile devices. The input now properly scrolls into view.
  • iPhone Notch Spacing Fix: Fixed spacing issues on older iPhones with notches where UI components like the timer were being blocked or cut off by the notch area.
  • Rapid Avatar Navigation Fix: Fixed an issue on mobile where rapidly tapping through avatars in the lobby persona card didn't register properly. Avatar selection now responds instantly to quick taps.
  • How to Play Title Wrapping: Fixed text overflow on the "How to Play" screen where the title was cutting off with ellipsis. Title now wraps cleanly to two lines on mobile devices.
  • iOS Safe Area Support: Added proper safe area insets to Privacy Policy, Terms of Service, and Changelog pages on native iOS devices. Content is no longer cut off by the notch, Dynamic Island, or bottom home indicator.
  • Party Mode Player List Fix: Fixed an issue where the host was incorrectly appearing in the "Eliminated Players" section for non-host players in Party Mode. The host now only appears in the "Game Master" section for all players.
  • Invite Friends Share Fix: Fixed the "Invite Friends" button for non-host players in the lobby. The button now properly opens the native share sheet on mobile devices instead of silently failing.
  • Party Mode Host Handoff Fix: Fixed an issue where the Settings Panel's "Game Master" section wouldn't update properly when host privileges were transferred to a new player. The old host and new host now see the correct player listed as Game Master, and the new host no longer appears in the "Alive Players" list.

v0.9.0

• Account Deletion
  • Full Account Control: You can now permanently delete your account when signed in through the Profile page. This removes all your data including game history and statistics.
  • Two-Step Confirmation: Account deletion requires double confirmation to prevent accidental deletions.
  • Seamless Experience: After deletion, you stay on the profile page and can immediately sign in with a different account if desired.
• Statistics Improvements
  • Enhanced Data Collection: Improved statistics tracking system for better game analytics.
  • Streamlined Profile: Removed placeholder statistics tab to focus on fully functional features.
• Profile Page Styling Updates
  • Refined Authentication UI: Improved profile page layout with better visual hierarchy.
  • Polished Danger Zone: Account deletion section features subtle, professional styling with centered labels and softer colors.
  • Better Name Display: Profile now properly shows your name from Google/Apple sign-in or email username as fallback.
• Production Ready
  • Beta Complete: Transitioned from beta to production release after successful testing phase.
  • Environment-Aware Badges: BETA badges now only appear in development and beta environments, not in production.
  • App Store Compliance: Minor tweaks to comply with App Store guidelines, including platform-specific adjustments for iOS.
• Audio Playback Fix
  • Background Music Resume: Fixed bug where background music would not resume after returning to the app or switching tabs.
  • Smart Resume Logic: Music now properly resumes only if it was playing when you left (not if manually muted).

v0.8.6.3-beta (Hotfix)

• 🔐 Authentication Fixes!
  • Sign-In Reliability: Fixed critical issues preventing sign-in with Google, Apple, and Email providers. All authentication methods now work reliably.
  • Cross-Origin Security: Resolved cross-origin frame access errors during OAuth authentication that were causing console warnings.
  • Instant Profile Updates: Profile page now updates immediately when you sign in, with smooth loading animations.
• Profile Page Improvements
  • Streamlined Auth UI: Cleaner authentication interface with "Sign in with:" header and simplified button labels (just "Apple", "Google", "Email").
  • Consistent Button Sizing: All authentication buttons now have uniform width and height across desktop and mobile.
  • Better Error Visibility: Error messages now appear at the top of forms where they're immediately visible.
  • Forgot Password: Added "Forgot Password" functionality for email sign-in.
  • Fixed Scroll Behavior: Can now properly scroll to top when signed in to access sign-out button and profile info.

v0.8.6.2-beta (Hotfix)

• Analytics Fix
  • Native Analytics: Fixed analytics implementation errors on native apps that were preventing proper event tracking.
  • Cleaner Console: Removed console error logs for analytics failures to reduce noise during development.
• Deep Linking Improvements
  • iOS QR Code Fix: Fixed issues with iOS deep linking from QR codes. Scanning a QR code now properly opens the native app if installed, or the web app if not.

v0.8.6.1-beta (Hotfix)

• Deep Linking Support
  • iOS Universal Links: QR codes and links now open directly in the native app on iOS devices when installed, providing a seamless experience.
  • Android App Links: QR codes and links now open directly in the native app on Android devices when installed.
  • Smart Fallback: If the app isn't installed, links automatically open in the web browser so users can still play via the web version.

v0.8.6-beta

• New Host Tutorial System!
  • Interactive Step-by-Step Guide: Brand new tutorial system that walks first-time hosts through every aspect of running a game. Features dynamic spotlights that highlight UI elements as you learn.
  • Smart Tutorial Prompts: Tutorial automatically appears for new hosts and remembers completion status, so you only see it once. Can be accessed anytime from settings.
• Cue Card System
  • Real-Time Host Prompts: New cue card feature provides context-aware prompts and narration scripts for every game phase. Never forget what to say or do next!
  • Multi-Step Guidance: Navigate through detailed step-by-step instructions for complex phases like night actions and day voting. Includes helpful tips for new hosts.
  • Always Accessible: Cue card button prominently displayed in header with unread indicator when content updates.
• UI & Styling Improvements
  • Optimized Header Layout: Redesigned host view header with better organization - cue cards on left, timer in center, settings on right.
  • Mobile Responsiveness: Both tutorial and cue card systems fully optimized for mobile with icon-only buttons and improved touch targets.
  • Glassmorphic Design: Enhanced visual consistency with beautiful glassmorphic styling across tutorial and cue card interfaces.

v0.8.5.1-beta (Hotfix)

• Bug Fix
  • Reveal Phase Card Locking: Fixed a small bug during the reveal phase for Party mode that was unlocking the cards prematurely. Cards now reveal at the correct time.

v0.8.5-beta

• Styling Improvements
  • Fluid Controls Throughout: Completely redesigned UI controls with smooth, fluid interactions that feel more responsive and polished across the entire app.
  • Overall Visual Refinements: Comprehensive styling improvements and minor tweaks throughout the application for a more cohesive and professional appearance.
• Enhanced Non-Host Lobby Panel
  • New Game Settings Panel: Added a new game settings panel for non-host players in the lobby, providing quick access to leave the game or mute audio without cluttering the interface.
• Critical Bug Fixes
  • Game Configuration Persistence: Fixed a bug where selecting game configurations would often switch back to default Classic mode even though Party mode was selected. Settings now persist correctly.
  • Lobby Name Saving: Resolved an issue when saving your name while in the lobby. Name changes now save reliably without errors.
  • Host Carousel Scrolling: Fixed a bug where hosts couldn't scroll to eliminated players on the carousel in Party mode. All players are now accessible regardless of status.
  • Party Mode Player Panel: Fixed an issue where the old Classic mode players panel was showing up for non-host players in Party mode. Now correctly displays the new, premium settings panel with smoother interactions.
  • Feedback Form Contrast: Improved text contrast in the feedback form dropdown, making it much easier to read and select options.
• Party Mode Host View Enhancements
  • Priority Card Sorting: Host mode now intelligently sorts cards from priority roles to non-priority roles in Party mode, making it easier to manage role assignments.

v0.8.4-beta

• Enhanced Lobby Experience
  • Redesigned Non-Host Lobby View: Players joining games now enjoy a cleaner, more focused lobby interface that highlights what matters most - getting ready to play!
  • Improved Host Lobby Interface: Completely redesigned host lobby with easier QR code sharing, clearer instructions for new hosts, and streamlined game setup controls. Reorganized style icons and added more relevant information to help you host better games.
  • Fullscreen QR Code View: Tap the QR code to open an elegant fullscreen view with the MafiaDeck logo embedded in the center - perfect for easy scanning on mobile devices!
  • Bug Fixes & Stability: Fixed numerous lobby issues for hosts, improving reliability and ensuring a smoother hosting experience. Fixed avatar selection responsiveness on mobile - rapid clicking now works perfectly smooth!
• Party Mode Host View Refinements
  • Role Shuffle Enhancement: Added a dedicated shuffle button next to the reveal button, making it easier to reshuffle roles before revealing them to players.
  • Smooth Card Animations: Beautiful new flip animations when shuffling and revealing roles, with polished visual effects that make the experience more engaging.
  • Clearer Game End Options: Simplified winner selection with clear labels when ending a game.
• Brand New In-Game Settings Panel
  • Cleaner, Polished Design: Completely redesigned in-game settings panel with a more organized and visually appealing layout.
  • Integrated Players Panel: Moved the Players panel into the Settings panel, reducing clutter and creating a unified hub for all important game controls.
  • Better Organization: All game settings and player management now in one convenient location, making it easier to manage your game mid-session.
• Mobile Experience Enhancements
  • Automatic Audio Management: Audio now pauses automatically when you switch apps or answer a call, and resumes when you return to the game - perfect for mobile gameplay!
  • Optimized Visual Performance: Refined visual effects on mobile for smoother performance without sacrificing style.
• Landing Page Refinements
  • Accurate Mode Descriptions: Updated game mode descriptions to clearly explain Party Mode and Classic Mode, helping new players choose the right experience.
  • Improved Analytics Tracking: Better tracking of user interactions to help us understand what features players love most.
  • Discord Community Integration: Added Discord link for easier community engagement and support.
  • Visual Polish: Cleaner design with improved button styles, sequential animations in the "How to Play" section, and better mobile responsiveness.

v0.8.3-beta

• Mobile Release Preparation
  • Native App Optimizations: Comprehensive mobile app preparation for iOS and Android release. Improved performance across all mobile devices with optimized rendering and reduced memory footprint.
  • Touch & Gesture Enhancements: Refined touch interactions and gesture support throughout the app for a native-like mobile experience.
• Game Mode Naming Updates
  • Party Mode (formerly Host Mode): Renamed to better reflect its purpose as a party organizer tool, giving the host complete control over the game experience.
  • Classic Mode (formerly Automated Mode): Renamed to Classic Mode to emphasize the traditional, fully automated Mafia gameplay experience.
• Instant Join Link System
  • Share & Join Instantly: New join link feature allows players to instantly join games through a shareable URL or QR code, eliminating the need to manually enter game codes.
  • QR Code Support: Generate QR codes for easy in-person game joining. Perfect for parties and game nights!
• Enhanced Party Mode Controls
  • Simultaneous Role Reveal: New ability for hosts in Party Mode to reveal all player roles at the same time, streamlining the setup phase for in-person games.
  • Win Tracking Across Rounds: Track wins across multiple game rounds, giving hosts persistent statistics and better control over tournament-style play.
  • Individual Player Control: Enhanced manual controls for managing specific players, including role assignment, revival, and elimination with granular precision.
• Simplified Lobby Experience
  • Streamlined Non-Host View: Simplified lobby interface for non-hosting players, removing unnecessary information and clutter.
  • Quick Ready System: Players can now mark themselves as ready quickly without navigating through complex settings, speeding up game starts.
• Lobby Stability Improvements
  • Return to Lobby Fixes: Resolved issues with returning to the lobby after a game, ensuring smooth transitions and proper state cleanup.
  • Settings Switching Stability: Fixed bugs when switching game settings mid-lobby, preventing state inconsistencies and ensuring reliable configuration changes.
  • Relaunch Without Creating New Lobby: Players can now relaunch games without needing to create a new lobby, maintaining the same game code and player list for seamless consecutive games.
• Major Styling Enhancements
  • Glassmorphic Host Interface: Beautiful new glassmorphic design for host mode interface, making it incredibly easy for party hosts to manage games with style.
  • Animation Fluidity: Dramatically improved animation smoothness across all game phases. Transitions now feel buttery smooth.
  • Visual Consistency: Comprehensive styling updates ensuring every screen follows our polished design language.
• Performance & Reliability
  • Optimized Voting System: Significantly improved performance when players vote, with instant visual feedback and less lag even in full lobbies.
  • Enhanced Visual Feedback: Host actions now show immediate visual confirmation to prevent double-clicks and backend errors. Every button press is acknowledged instantly.
  • Backend Error Prevention: Robust error handling ensures host actions are fully processed before allowing new actions, preventing state inconsistencies.
• Bug Fixes & Additional Stability
  • Fixed Vote Processing: Resolved edge cases in vote counting that could cause delays or incorrect tallies.
  • Mobile Keyboard Issues: Fixed input field focus problems on mobile devices that caused keyboard flickering.
  • Connection Recovery: Better handling of network interruptions with improved reconnection logic.

v0.8.2-beta

• UI/UX Improvements
  • Enhanced Button Hover Animations: All buttons on the main page now have consistent, smooth hover animations for better visual feedback.
  • How to Play Navigation: Added intuitive back button in the top-left corner of tutorial cards. Removed rotation effects for cleaner card presentation when viewing tutorials.
  • Discord Community Button: Added prominent Discord button on the main page to help players easily find and join our community for discussions and feedback.
  • Layout Refinements: Improved spacing and padding in the How to Play section for better readability. Tutorial cards now display without unnecessary margins.

v0.8.1-beta

• Party Mode Improvements
  • Fixed Role Synchronization: Resolved a critical bug where rapid clicking of the shuffle button in host mode could cause inconsistent role assignments between players.
  • Mobile UI Enhancements: Improved styling and layout of host mode components on mobile devices. Role peek cards are now more visible across all screen sizes.
  • Carousel Centering Fix: Fixed polaroid card centering issues in the host mode carousel, ensuring selected players are properly centered on all devices.
  • New Reset All Button: Added a "Reset All" button in host mode that instantly revives all eliminated players, making it easy to restart games without reassigning roles.

v0.8.0-beta

• Official Beta Launch
  • Major Real-Time Syncing Overhaul: Completely rebuilt the server synchronization architecture from the ground up. Players now experience instantaneous updates with zero lag, even with full lobbies and complex game states.
  • Performance Optimization Across All Devices: Extensive performance enhancements ensure smooth gameplay on everything from high-end desktops to budget mobile devices. Memory usage reduced by 40%, rendering optimized for 60fps.
  • Party Mode for Quick Setup: New party mode allows party organizers to quickly launch games without physical cards. One-click role assignment, streamlined player onboarding, and simplified game management for in-person play.
• Advanced AI Bot System
  • 5 Unique Bot Personalities: Each bot now has distinct behavioral patterns, decision-making styles, and strategic approaches that make every game feel different.
  • Dynamic Truth & Deception: Bots can now lie, bluff, and deceive just like human players. They'll defend themselves when accused, create false alibis, and even frame innocent players.
  • Bot Thought Bubbles: Revolutionary AI speech system shows what bots are thinking during gameplay. Watch as they reason through decisions, express suspicions, and react to events in real-time.
  • 100+ Unique Dialogue Lines: Extensive dialogue system with contextual responses, making bot interactions feel natural and engaging. No more repetitive bot behavior!
  • Solo Play Optimization: Play complete games against intelligent bots that provide a challenging and entertaining single-player experience.
• Landing Page & UI Refinements
  • Optimized Landing Page: Completely redesigned landing page with improved performance, faster load times, and better conversion flow for new players.
  • Enhanced Visual Polish: Refined animations, smoother transitions, and consistent design language throughout the entire application.
  • Mobile-First Optimization: Every interface element now perfectly adapted for touch screens with improved gesture support and responsive layouts.
• Beta Monitoring & Stability
  • Extensive Logging System: Comprehensive monitoring infrastructure to track game health, identify issues, and ensure stable gameplay throughout the beta phase.
  • Error Recovery: Intelligent error handling that gracefully recovers from connection issues, ensuring games continue smoothly even with network interruptions.
  • Performance Metrics: Real-time performance tracking to maintain optimal gameplay experience across all active games.
• Game Experience Enhancements
  • Voting System Improvements: Real-time vote preview, animated vote tallying, and clearer vote results display with dramatic reveal sequences.
  • Night Action Refinements: Smoother night phase transitions, clearer action feedback, and improved role-specific interfaces.
  • Win Condition Polish: Enhanced game-ending sequences with better victory/defeat presentations and comprehensive game statistics.
  • Session Persistence: Games now properly maintain state across reconnections, allowing players to rejoin seamlessly after connection drops.

v0.7.1-alpha

• Major Performance & Database Refactoring
  • Fast Synchronization: Completely rebuilt the backend architecture for dramatically improved performance when multiple players are connected simultaneously. Still not perfect, but we're getting there!
  • Database Optimization: Extensive database updates that reduce latency and ensure seamless real-time updates across all connected devices.
  • Enhanced Multi-Player Stability: Under-the-hood improvements that eliminate lag and synchronization issues during peak gameplay moments.
  • Optimized Data Flow: Streamlined data processing that makes every action feel instant and responsive, even with full lobbies.
• Major Style & Interface Overhaul
  • Refined Visual Design: Comprehensive style updates across the entire game with improved color schemes, typography, and visual hierarchy.
  • Enhanced Role Interfaces: Every role now features updated, more intuitive interfaces tailored specifically for optimal gameplay experience.
  • Polished UI Components: Extensive refinements to buttons, cards, panels, and interactive elements for a more cohesive and professional appearance.
  • Improved Visual Feedback: Better visual cues and animations that make game state changes clear and engaging for all players.
• Comprehensive Bug Fixes & Stability
  • Smoother Gameplay Experience: Resolved numerous UI bugs that were affecting game flow, ensuring uninterrupted gameplay from start to finish.
  • Enhanced Timer System: Improved phase timing with more accurate countdowns and seamless transitions between day, night, and voting phases.
  • Better Phase Shifting: Eliminated edge cases in phase transitions that could cause confusion or game state inconsistencies.
  • Refined Role Reveal: Enhanced the role reveal experience with better animations, clearer information display, and improved timing.
• Behind-the-Scenes Performance Improvements
  • Optimized Real-Time Engine: Major improvements to the core synchronization system that powers multi-player interactions.
  • Reduced Memory Usage: More efficient resource management that keeps the game running smoothly even during extended play sessions.
  • Enhanced Error Handling: Better error detection and recovery systems that prevent minor issues from disrupting gameplay.
  • Improved Connection Stability: Stronger network handling that maintains game state even with temporary connection fluctuations.

v0.7.0-alpha

• Massive Visual & Animation Overhaul
  • Stunning Card Animations: Complete redesign of all card interactions with smooth flip animations, elegant hover effects, and seamless transitions that bring the game to life.
  • Enhanced Game Animations: Every aspect of gameplay now features polished animations - from voting sequences to phase transitions, creating a truly immersive experience.
  • Beautiful Avatar System: Gorgeous new avatar artwork with improved styling and animations. Players can now see their character come to life with enhanced visual fidelity.
  • Refined Icons & UI Elements: Comprehensive icon refresh with better contrast, sizing, and visual hierarchy throughout the entire interface.
• Personalized Avatar Selection
  • Choose Your Look: Players can now select from a variety of beautiful avatars to represent their persona in the game, adding a personal touch to every match.
  • Avatar Consistency: Your chosen avatar appears consistently across all game phases, voting screens, and result displays for a cohesive experience.
  • Visual Identity: Other players will see your chosen avatar, making it easier to recognize and remember each other throughout the game.
• Intelligent Bot Players
  • Add Bots to Fill Games: Hosts can now add AI-controlled bot players to fill out lobbies and ensure games can start even with fewer human players.
  • Smart Bot Behavior: Bots automatically participate in voting and night actions with realistic timing, making games feel natural and engaging.
  • Seamless Integration: Bot players blend seamlessly with human players, maintaining game balance and flow without disruption.
• Advanced Role-Specific Tools
  • Specialized Interfaces: Each role now has custom tools and interfaces tailored to their unique abilities and gameplay needs.
  • Enhanced Detective Tools: Investigation interface with improved targeting and result display systems.
  • Doctor Protection Interface: Streamlined healing tools with clear feedback on protection status.
  • Mafia Coordination: Enhanced night action interface for coordinated elimination planning.
• Dynamic Player Drawers & Voting Animations
  • Interactive Player Panels: New sliding player drawers that provide detailed information and quick access to player actions.
  • Smooth Voting Animations: Beautiful vote casting animations with real-time visual feedback that make every decision feel impactful.
  • Live Vote Tracking: Watch votes appear in real-time with elegant animations showing the current voting status.
  • Enhanced Player Status: Clear visual indicators for player states, roles, and current actions throughout all game phases.
• Major Game Flow & Stability Improvements
  • Game Logic: Extensive refinements to game flow that eliminate edge cases and prevent game-breaking scenarios.
  • Error Prevention: Closed numerous loopholes that could cause game errors, ensuring smooth gameplay from start to finish.
  • Improved Phase Transitions: Seamless transitions between day, night, and results phases with proper win condition checking.
  • Enhanced Backend Logging: Comprehensive logging system that provides better debugging and monitoring capabilities for optimal game performance.
  • Robust State Management: Improved game state handling that prevents desynchronization and ensures all players stay in sync.
• Performance & Polish Enhancements
  • Optimized Animations: All animations now run smoother with better performance across all devices and browsers.
  • Memory Management: Improved resource handling for longer game sessions without performance degradation.
  • Responsive Design Updates: Enhanced mobile and tablet experiences with better touch interactions and layouts.
  • Accessibility Improvements: Better keyboard navigation and screen reader support for inclusive gameplay.

v0.6.0-alpha

• Brand New Landing Page Experience
  • Complete Visual Overhaul: We've built a stunning new landing page from scratch with a modern, glassmorphic design that feels premium and engaging.
  • Professional Marketing Site: Transformed from a simple game demo into a beautiful, professional marketing website that showcases MafiaDeck's potential.
  • Immersive Card Previews: See gorgeous 3D card previews with smooth hover animations that give you a taste of the beautiful artwork waiting in the game.
• Join the Waitlist for Early Access!
  • Get Notified When We Launch: You can now sign up with your email to be the first to know when MafiaDeck goes live! We've replaced the old demo buttons with a proper waitlist signup.
  • Two Ways to Join: Sign up right in the hero section or scroll down to the main call-to-action area - both get you on the list for early access, exclusive beta features, and zero spam.
  • Friendly Notifications: When you sign up, you'll see elegant popup notifications that slide in smoothly and disappear automatically.
• Modernized Design & Animations:
  • Glassmorphic Visual Style: Experience the cutting-edge glassmorphic design trend with translucent elements, beautiful blur effects, and depth that makes everything feel modern and premium.
  • Optimized Animations: Every animation has been fine-tuned for smoothness and performance - from page transitions to button hovers, everything feels buttery smooth.
  • Enhanced Lobby Experience: The game lobby now features refined animations, better visual feedback, and a more polished overall experience.
  • Perfect Mobile Experience: Everything works flawlessly on your phone with responsive design that adapts beautifully to any screen size.
• Real Development Progress:
  • Honest Progress Tracking: An authentic look at what we've actually built and what's coming next, with clear icons showing completed features (🎯 game logic, 🎨 artwork, ⚡ real-time engine).
  • Updated Launch Timeline: Realistic dates reflecting where we actually are.
• Hundreds of Bug Fixes & Improvements:
  • Performance Optimizations: The entire experience is now faster and more responsive, with optimized animations and smoother interactions throughout.
  • Polish Everywhere: Countless small improvements, bug fixes, and refinements that make every interaction feel more polished and professional.
  • Better Navigation: Improved site structure with cleaner navigation and useful footer links to our other projects.

v0.5.0-alpha

• Beautiful New Role Cards:
  • Brand new SVG artwork for all role cards! Each role now has its own unique, beautifully designed card that you'll see during the reveal phase.
  • Cards feature custom illustrations for Civilian, Mafia, Detective, Doctor, and Jester.
• Completely Automatic Game Flow:
  • Games now run automatically with built-in timers! No more waiting for the host to manually advance phases.
  • After role reveal, Day 1 starts automatically with a 10-second countdown.
  • Day and night phases transition seamlessly with customizable timers.
  • Players can discuss and vote during the day, and special roles act at night - all with clear time remaining displays.
• Stunning Dark Theme & Visual Overhaul:
  • MafiaDeck now features a gorgeous dark theme that's easier on the eyes and more immersive.
  • Consistent new color scheme with rich browns, golds, and deep reds that give the game a sophisticated Mafia atmosphere.
  • Smooth custom scrollbars and improved visual polish throughout the entire app.
• Enhanced Game Experience:
  • All-new main game screen with real-time player status, voting, and role-specific actions.
  • Improved lobby with better game settings and instant feedback.
  • Animated role reveal experience with card flip animations and atmospheric transitions.
  • Day 1 now includes voting - players can eliminate someone suspicious or vote for no elimination.
• Better Performance & Reliability:
  • Completely rewritten backend with improved game logic, better error handling, and more reliable state management.
  • Enhanced Firebase integration for smoother real-time updates.
  • Better loading states and error messages to keep you informed of what's happening.
• Developer & Testing Improvements:
  • New "Add Fake Players" feature in development mode for faster testing.
  • Improved local development setup with full Firebase emulator support.
  • Better code organization and documentation for future updates.
• Responsive Design:
  • All new screens are fully responsive and work beautifully on mobile, tablet, and desktop.
  • Improved touch interactions and mobile-friendly layouts throughout.

v0.4.2-alpha

• Enhanced "How to Play" Experience:
  • The "How to Play" guide now offers a smoother reading experience, with improved scrolling that feels more natural on all devices.
  • Instructional cards on the "How to Play" page now glide into view with a neat animation on mobile, matching the desktop experience.
• Improved Readability:
  • We've fine-tuned the text size on our information pages (like Terms, Privacy, and the Changelog itself) to make them easier on the eyes.

v0.4.1-alpha

• Lobby Settings & UI Polish:
  • Clearer Settings Explanations: Added helpful tooltips to all game settings in the lobby, so you know exactly what each option does.
  • "Recommended Players" Up Front: This suggestion is now displayed at the top of the settings list for better visibility and is clearly marked as a non-editable recommendation.
  • Consistent Tooltip Icons: All tooltip icons are now uniformly placed after the setting label for a cleaner look.
  • Simplified Player Count: Renamed "Player Limit" to "Max. Players" and positioned "Min. Players" before it for a more logical flow.
• Improved Mobile & Static Page Experience:
  • Fixed Mobile Viewport: Pages like Home, Join, Create, About, and other info pages now strictly adhere to the screen height on mobile, preventing accidental scrolling for a smoother, app-like feel.
• Smoother Animations:
  • Enhanced Card Animation: The background cards on the main welcome screen now have a more distinct "fold out" animation when the page first loads.

v0.4.0-alpha

• A Whole New Look & Feel!
  • Experience a visually refreshed MafiaDeck! We've introduced a new card-style design across the entire app, making it more intuitive and stylish.
  • Enjoy smoother transitions between screens with our new page flip animation.
  • Buttons, forms, and text are now more polished and consistent for a better experience.
  • Added a subtle glow to the main cards for a touch of class.
  • New dynamic background card effects add more visual depth to your game screens.
• Brand New Identity:
  • MafiaDeck now sports a brand new logo and browser icon, making it easier to recognize!
• Explore More & Easier Navigation:
  • Discover new sections: "About" (learn more about the game and its creators), "Privacy Policy", "Terms of Service", and this very "Changelog".
  • Getting back to the main screen is simpler with "Back to Home" links on all sub-pages.
  • Quickly access the "About" page via a new icon on the Home screen.
• Smoother Experience & Fixes:
  • We've squashed some pesky scrollbar bugs and made sure everything fits perfectly on your screen.
  • The main game screens now look great and consistently fill your view.
  • Joining and Creating games is now more visually consistent and user-friendly.
• Streamlined Game Creation:
  • Creating a new game is now quicker! Just enter a name for your lobby to get started. More detailed game settings will be available on the lobby screen soon.

v0.3.0-alpha

• Major Lobby Overhaul & Customization:
  • Personalize Your Identity: Players can now edit their display names directly in the lobby! A handy "(You)" indicator makes it easy to spot yourself in the player list.
  • Distinct Lobby Names: Game creators now set a "Lobby Name" separate from their own player name, which is now auto-generated and also editable.
  • Host-Controlled Game Settings: The game host now has the power to customize a wide array of game settings directly from the lobby!
    • Fine-tune player limits (min/max, recommended range).
    • Adjust day and night cycle durations.
    • Select which roles are active in the game from an expanded list (Mafia, Townsfolk, Doctor, Detective, Sheriff, Vigilante, Jester, Executioner).
    • Configure role assignment modes and ratios for automatic setups.
    • Toggle options like revealing roles on death, anonymous voting, and more.
  • Streamlined UI: The settings edit controls are now neatly integrated into the settings list for a cleaner look. Player name editing is also more intuitive with improved icon placement and input field sizing.
  • "Mark as Ready" Fixed: Players can now reliably mark themselves as ready, and this status will persist correctly.
• Enhanced User Experience & Styling:
  • Improved Mobile & Desktop Scrolling: We've resolved issues with page scrolling on mobile devices, ensuring content is always accessible. Desktop views now maintain a clean, scrollbar-free appearance where intended.
  • Responsive Lobby Cards: The lobby cards strip now supports horizontal scrolling on smaller desktop screens, preventing layout issues.
• Backend & Stability Improvements:
  • Core game creation and player management functions have been updated to support the new lobby and settings features.

v0.2.1-alpha

• "How to Play" Enhanced for Mobile:
  • The "How to Play" section is now much easier to read on mobile devices! Cards stack vertically, allowing you to simply scroll down to view all the rules.
  • Card animations on the "How to Play" page are now consistent across desktop and mobile.
  • Improved scrolling on mobile for a smoother experience on the "How to Play" page.
• General Enhancements:
  • Implemented various animation tweaks and styling improvements across the application for a more polished and cohesive user experience.

v0.2.0-alpha

• A Whole New Look & Feel!
  • Experience a visually refreshed MafiaDeck! We've introduced a new card-style design across the entire app, making it more intuitive and stylish.
  • Enjoy smoother transitions between screens with our new page flip animation.
  • Buttons, forms, and text are now more polished and consistent for a better experience.
  • Added a subtle glow to the main cards for a touch of class.
  • New dynamic background card effects add more visual depth to your game screens.
• Brand New Identity:
  • MafiaDeck now sports a brand new logo and browser icon, making it easier to recognize!
• Explore More & Easier Navigation:
  • Discover new sections: "About" (learn more about the game and its creators), "Privacy Policy", "Terms of Service", and this very "Changelog".
  • Getting back to the main screen is simpler with "Back to Home" links on all sub-pages.
  • Quickly access the "About" page via a new icon on the Home screen.
• Smoother Experience & Fixes:
  • We've squashed some pesky scrollbar bugs and made sure everything fits perfectly on your screen.
  • The main game screens now look great and consistently fill your view.
  • Joining and Creating games is now more visually consistent and user-friendly.
• Streamlined Game Creation:
  • Creating a new game is now quicker! Just enter a name for your lobby to get started. More detailed game settings will be available on the lobby screen soon.

v0.1.0-alpha

• Welcome to the First Version of MafiaDeck!
• Core Features Ready for Action:
  • You can now create your own game lobbies and get a unique code to share with friends.
  • Players can easily join existing games using a game code.
  • The game keeps everyone in sync for a smooth experience.
• First Set of Screens:
  • A Home screen to welcome you and let you choose to join or create a game.
  • A "Create Game" page to set up your new game session.
  • A "Join Game" page to jump into the action with a code.
  • A basic "How to Play" page to get you started.
• The First Look:
  • The initial design and feel of MafiaDeck was born, setting the stage for future improvements!