A comprehensive match-3 puzzle game with home renovation mechanics, featuring progressive storylines, currency systems, and monetization strategies.
Home Sweet Puzzle combines addictive match-3 puzzle gameplay with satisfying home renovation mechanics. Players complete puzzle levels to earn currency, which they spend on furniture and decorations to transform rundown spaces into beautiful homes.
- Match-3 Puzzle Engine: Swap tiles, create matches, and use power-ups
- Home Renovation System: Purchase and place furniture in multiple rooms
- Progressive Storyline: Character-driven narrative that unlocks with progress
- Currency Economy: Coins and stars with balanced earning/spending mechanics
- Monetization Integration: In-app purchases, ads, and season pass system
Experience the visual richness and engaging gameplay mechanics of Home Sweet Puzzle through our comprehensive screenshot gallery.
Get a feel for the core puzzle mechanics that drive the game experience.
Colorful match-3 puzzle board with various tile types and objectives
Special power-ups creating explosive chain reactions
Satisfying cascade effects from strategic tile matches
See how puzzle success translates into beautiful home transformations.
A room waiting to be transformed with your design choices
Browse and select from hundreds of furniture items across different categories
The same room completely transformed into a beautiful living space
Discover the rich storyline that unfolds as you progress through the game.
Meet Maya, your renovation mentor, who guides you through your first projects
Engaging narrative that provides context and motivation for each renovation project
Make meaningful choices that affect your relationships and story outcomes
Explore the various ways to enhance your gameplay experience.
Track your coins, stars, and lives with the intuitive currency interface
Purchase helpful boosters and power-ups to tackle challenging levels
Unlock exclusive content and rewards with the premium season pass
Note: Screenshots show placeholder content. Actual gameplay may vary as features are continuously updated and improved.
- Modern web browser (Chrome, Firefox, Safari, Edge)
- Local web server (for development)
- Clone or download the project files
- Open
index.htmlin a web browser, or - Serve the files using a local web server:
# Using Python 3
python -m http.server 8000
# Using Node.js (http-server)
npx http-server
# Using PHP
php -S localhost:8000- Navigate to
http://localhost:8000in your browser
- Play Puzzle Levels: Complete match-3 challenges with limited moves
- Earn Currency: Receive coins and stars based on performance
- Buy Furniture: Purchase items from different categories (Essential, Decorative, Premium)
- Decorate Rooms: Place furniture to increase room completion stars
- Unlock Content: Progress through story and unlock new rooms/features
/
├── index.html # Main game entry point
├── css/ # Stylesheets
│ ├── main.css # Core UI styles
│ ├── puzzle.css # Match-3 game styles
│ └── renovation.css # Renovation interface styles
├── js/ # JavaScript modules
│ ├── core/ # Core game systems
│ │ ├── Game.js # Main game controller
│ │ ├── StateManager.js # Game state management
│ │ └── SaveSystem.js # Save/load functionality
│ ├── puzzle/ # Match-3 game logic
│ │ ├── PuzzleEngine.js # Core puzzle mechanics
│ │ ├── Board.js # Game board management
│ │ ├── Tile.js # Individual tile logic
│ │ └── PowerUps.js # Special abilities
│ ├── renovation/ # Home renovation system
│ │ ├── RenovationManager.js # Renovation controller
│ │ ├── Room.js # Room management
│ │ ├── Furniture.js # Furniture items
│ │ └── Inventory.js # Player inventory
│ ├── economy/ # Currency and monetization
│ │ ├── Currency.js # Currency management
│ │ ├── Shop.js # In-app purchases
│ │ └── Rewards.js # Achievements and bonuses
│ ├── story/ # Narrative system
│ │ ├── StoryManager.js # Story progression
│ │ └── DialogSystem.js # Character interactions
│ └── ui/ # User interface
│ ├── UIManager.js # UI controller
│ ├── MenuSystem.js # Navigation
│ └── Notifications.js # Feedback system
└── assets/ # Game assets (placeholder)
├── images/ # Graphics and sprites
├── sounds/ # Audio files
└── data/ # Game data files
- Board Management: 8x8 grid with customizable tile types
- Match Detection: Horizontal and vertical matches of 3+ tiles
- Cascade Mechanics: Tiles fall and refill automatically
- Power-ups: Hammer, Bomb, Shuffle, and special tiles
- Objectives: Collect specific tile types or clear obstacles
- Multiple Rooms: Kitchen, Living Room, Bedroom, and more
- Furniture Categories: Essential, Decorative, and Premium items
- Placement System: Drag-and-drop with collision detection
- Star Rating: 1-3 stars based on room completion
- Theme Compatibility: Furniture themes affect bonuses
- Coins: Primary currency for furniture and boosters
- Stars: Premium currency for exclusive items
- Lives: Energy system for playing levels
- Daily Bonuses: Login rewards and consecutive day bonuses
- In-App Purchases: Currency packs, boosters, premium furniture
- Rewarded Ads: Free currency, extra moves, bonus lives
- Season Pass: Monthly subscription with exclusive content
- Limited Events: Special offers and themed content
- Game: Main controller managing all systems
- PuzzleEngine: Core match-3 game logic
- RenovationManager: Handles furniture and room management
- Currency: Manages all in-game currencies and transactions
- StoryManager: Controls narrative progression and character dialogs
// Add to Inventory.js furniture database
'new_item_id': {
name: 'Item Name',
type: 'furniture_type',
category: 'essential|decorative|premium',
price: 500,
currency: 'coins|stars',
size: { width: 80, height: 60 },
theme: 'modern|traditional|luxury'
}// Add to PuzzleEngine.js level configuration
levelNumber: {
moves: 25,
objectives: { red: 10, blue: 8 },
boardSize: { width: 8, height: 8 },
tileTypes: ['red', 'blue', 'green', 'yellow'],
obstacles: []
}// Add to StoryManager.js story content
'story_id': {
title: 'Story Title',
character: 'character_id',
dialogs: [/* dialog objects */],
rewards: { coins: 100, stars: 1 },
unlockRequirement: { type: 'level', value: 5 }
}- Mouse/Touch: Click and drag to swap tiles
- Power-ups: Click power-up buttons, then click target
- Pause: Click pause button or press 'P'
- Furniture Selection: Click furniture cards to select
- Placement: Click in room to place selected furniture
- Categories: Switch between Essential, Decorative, Premium tabs
- Back Buttons: Return to previous screen
- Escape Key: Close modals and dialogs
- Keyboard Shortcuts: 'S' to save, 'R' to refresh room
- Multiplayer: Compete with friends in puzzle challenges
- Guilds: Join teams for collaborative events
- AR Mode: View renovated rooms in augmented reality
- Custom Rooms: Create and share room designs
- Seasonal Events: Holiday-themed content and rewards
- WebGL Renderer: Enhanced graphics and animations
- Audio System: Background music and sound effects
- Analytics Integration: Player behavior tracking
- Cloud Save: Cross-device progress synchronization
- Localization: Multi-language support
The game is designed to be mobile-friendly with:
- Responsive Design: Adapts to different screen sizes
- Touch Controls: Optimized for touch input
- Performance: Efficient rendering for mobile devices
- Offline Play: Core gameplay works without internet
- Modify CSS files to change visual appearance
- Update color schemes in CSS custom properties
- Replace placeholder graphics with custom artwork
- Adjust currency earning rates in
Currency.js - Modify furniture prices in
Inventory.js - Tune puzzle difficulty in
PuzzleEngine.js
- Configure IAP prices in
Shop.js - Adjust ad reward amounts in
Currency.js - Customize season pass benefits in
Shop.js
This project is provided as an educational example. Feel free to use and modify for learning purposes.
This is a demonstration project, but suggestions and improvements are welcome! Consider:
- Code optimization and best practices
- Additional game features and mechanics
- UI/UX improvements
- Mobile performance enhancements
For questions about the code structure or implementation details, please refer to the inline documentation within each JavaScript file.
Ready to experience Home Sweet Puzzle? Here's how to get started:
Before diving in, check out our Gameplay Screenshots section above to see:
- Match-3 puzzles with colorful tiles and power-ups
- Renovation interface showing before/after transformations
- Character interactions that drive the engaging storyline
- Shop features for boosters and premium content
- Launch the game: Open
index.htmlin your web browser - Learn the basics: Start with the tutorial level to master the mechanics
- Earn currency: Complete puzzle levels to collect coins and stars
- Transform rooms: Use your earnings in renovation mode to decorate spaces
- Enhance gameplay: Visit the shop for helpful power-ups and premium content
The screenshots above show exactly what you'll experience during each step of this journey!
Experience seamless development with our containerized environment that serves the game's static assets via HTTP.
-
Build and run the game server:
docker-compose up --build
-
Access the game:
- Production server: http://localhost:8080
- Development server (with live reload): http://localhost:8081
-
Stop the containers:
docker-compose down
# Build the Docker image
docker build -t addictive-game .
# Run production container
docker-compose up game-server
# Run development environment with live file watching
docker-compose --profile dev up game-dev
# View running containers
docker-compose ps
# View container logs
docker-compose logs game-server
# Remove containers and networks
docker-compose down --remove-orphans- 🔒 Security: Non-root user, minimal attack surface
- 📦 Optimized: Multi-stage build with .dockerignore
- 🔄 Caching: Efficient layer caching for faster builds
- 🩺 Health Checks: Built-in container health monitoring
- 🌐 CORS: Cross-origin resource sharing enabled
- 🔧 Development: Optional dev mode with volume mounting
The Docker container serves all static game assets from app/src/main/assets/:
index.html- Main game entry pointcss/- Stylesheets for game interfacejs/- Complete JavaScript game engine
Perfect for Android development environments, testing, and deployment!
- 24 JavaScript files with over 9,000 lines of code
- Complete match-3 engine with advanced mechanics
- Full renovation system with multiple room types
- Comprehensive monetization framework
- Mobile-optimized responsive design
- Production-ready architecture
Home Sweet Puzzle - Transform houses into homes, one match at a time! 🏠✨