react-native-games 1.0.0 → 1.2.0

package/README.md

@@ -1,369 +1,81 @@
 # 🎮 react-native-games
 
-**react-native-games** is a collection of 14 high-performance games for your React Native projects. Built with modern React Native technologies including Skia, Reanimated, Gesture Handler and TypeScript for smooth 60fps gameplay across iOS, Android, and Web platforms.
-
-<table style="border: none;">
-<tr style="border: none;">
-<td width="33%" style="border: none; vertical-align: top;">
-
-### 🚀 High Performance
-- 60fps gameplay with React Native Skia
-- Optimized animations using Reanimated 3
-- Delta time physics loops
-- React.memo optimizations
-- Minimal re-renders with direct store subscriptions
-
-</td>
-<td width="33%" style="border: none; vertical-align: top;">
-
-### 📱 Cross-Platform
-- iOS, Android, and Web support
-- Consistent performance across platforms
-- Responsive design for all screen sizes
-- Dynamic offset handling for notches
-- Adaptive UI components
-
-</td>
-<td width="33%" style="border: none; vertical-align: top;">
-
-### 🎵 Rich Audio & Haptics
-- Sound effects and speech synthesis
-- Haptic feedback for immersive experience
-- Configurable audio settings
-- Per-game sound customization
-
-</td>
-</tr>
-<tr style="border: none;">
-<td width="33%" style="border: none; vertical-align: top;">
-
-### 🎯 Customizable
-- Multiple difficulty levels
-- Adjustable game parameters
-- Persistent settings storage
-- Unified settings interface
-
-</td>
-<td width="33%" style="border: none; vertical-align: top;">
-
-### 🎮 Game Features
-- Physics simulation and collisions
-- Particle systems and visual effects
-- Procedural generation (mazes, obstacles)
-- Score systems and achievements
-- Progressive difficulty scaling
-
-</td>
-<td width="33%" style="border: none; vertical-align: top;">
-
-### 🛠️ Developer Friendly
-- TypeScript support throughout
-- Shared components (GameControlButton, ScoreBoard)
-- Consistent API across all games
-- Easy integration and customization
-- Comprehensive documentation
-
-</td>
-</tr>
-</table>
+**react-native-games** is a collection of high-performance games for your React Native projects. Built with modern React Native technologies including Skia, Reanimated, Gesture Handler and TypeScript for smooth 60fps gameplay across iOS, Android, and Web platforms.
+
+<div style="display: grid; grid-template-columns: repeat(3, 1fr); gap: 20px; margin: 20px 0;">
+
+<div>
+<strong>🚀 High Performance</strong><br/>
+• 60fps gameplay with React Native Skia<br/>
+• Optimized animations using Reanimated 3<br/>
+• Delta time physics loops<br/>
+• React.memo optimizations<br/>
+• Minimal re-renders with direct store subscriptions
+</div>
+
+<div>
+<strong>📱 Cross-Platform</strong><br/>
+• iOS, Android, and Web support<br/>
+• Consistent performance across platforms<br/>
+• Responsive design for all screen sizes<br/>
+• Dynamic offset handling for notches<br/>
+• Adaptive UI components
+</div>
+
+<div>
+<strong>🎵 Rich Audio & Haptics</strong><br/>
+• Sound effects and speech synthesis<br/>
+• Haptic feedback for immersive experience<br/>
+• Configurable audio settings<br/>
+• Per-game sound customization
+</div>
+
+<div>
+<strong>🎯 Customizable</strong><br/>
+• Multiple difficulty levels<br/>
+• Adjustable game parameters<br/>
+• Persistent settings storage<br/>
+• Unified settings interface
+</div>
+
+<div>
+<strong>🎮 Game Features</strong><br/>
+• Physics simulation and collisions<br/>
+• Particle systems and visual effects<br/>
+• Procedural generation (mazes, obstacles)<br/>
+• Score systems and achievements<br/>
+• Progressive difficulty scaling
+</div>
+
+<div>
+<strong>🛠️ Developer Friendly</strong><br/>
+• TypeScript support throughout<br/>
+• Shared components (GameControlButton, ScoreBoard)<br/>
+• Consistent API across all games<br/>
+• Easy integration and customization<br/>
+• Comprehensive documentation
+</div>
+
+</div>
 
 ## 🎯 Available Games
 
-<table>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/fruit-ninja.png" alt="Fruit Ninja" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🍎 Fruit Ninja**  
-Slice flying fruits with finger swipes - avoid the bombs!
-
-• Fixed 60-second gameplay sessions  
-• Physics-based slicing with particle effects and combo system  
-• Difficulty affects fruit spawn rate and bomb frequency
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/candy-crush.png" alt="Candy Crush" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🍬 Candy Crush**  
-Match colorful candies in this puzzle game
-
-• Match-3 puzzle with colorful candies  
-• Create special candies with 4+ matches  
-• Cascading combos and satisfying animations  
-• Difficulty affects level objectives and move limits
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/flappy-bird.png" alt="Flappy Bird" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🐦 Flappy Bird**  
-Navigate bird through pipes with precise timing
-
-• Classic tap-to-flap mechanics with gravity physics  
-• Navigate through pipes with pixel-perfect collision  
-• Progressive difficulty with increasing pipe speed  
-• Difficulty affects pipe gap size and spawn frequency
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/colors-sort.png" alt="Colors Sort" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🎨 Colors Sort**  
-Sort colored liquids into matching tubes
-
-• Sort colored liquids into matching tubes  
-• Logic puzzle with increasing complexity  
-• Satisfying pour animations and sound effects  
-• Difficulty affects number of tubes and colors
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/dino-jump.png" alt="Dino Jump" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🦖 Dino Jump**  
-Chrome offline dino game - jump to avoid obstacles!
-
-• Endless runner with tap-to-jump mechanics  
-• Collect stars for extra lives (max 3 lives)  
-• Game durations: easy 2 mins, medium 3 mins, hard 5 mins  
-• Dynamic ground height based on device offset (150px or 250px)  
-• Difficulty affects obstacle spawn rate and game speed
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/popit-fidget.png" alt="Popit Fidget" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🫧 Popit Fidget**  
-Pop satisfying bubbles in this relaxing fidget toy game
-
-• Relaxing bubble popping with satisfying sound effects  
-• Different bubble shapes and colors for variety  
-• Difficulty affects bubble responsiveness and patterns
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/whack-a-mole.png" alt="Whack A Mole" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🐱 Whack A Mole**  
-Whack cute cats popping from holes - fast reflexes needed!
-
-• Cat spawn intervals: easy 2000ms, medium 1500ms, hard 1000ms  
-• Cat visible duration: easy 2500ms, medium 2000ms, hard 1500ms  
-• Grid sizes: easy/medium 3x3, hard 4x4
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/balloon-blaster.png" alt="Balloon Blaster" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🎈 Balloon Blaster**  
-Pop rising balloons before they escape - quick taps win!
-
-• Fixed 60-second gameplay sessions  
-• Balloon spawn interval: 1200ms, rise speed: 0.08  
-• Physics-based balloon movement with particle effects
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/space-fighter.png" alt="Space Fighter" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🚀 Space Fighter**  
-Pilot spaceship through asteroid fields in endless space
-
-• Horizontal drag controls with smooth spacecraft movement  
-• Dynamic spacecraft positioning based on device offset  
-• Progressive difficulty with asteroid spawn intervals  
-• 1-second collision immunity after each hit  
-• Difficulty affects asteroid speed and spawn frequency
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/maze-runner.png" alt="Maze Runner" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🧩 Maze Runner**  
-Navigate ball through mazes using tilt and physics controls
-
-• Grid sizes: easy 8x8, medium 10x10, hard 12x12  
-• Procedurally generated mazes with intelligent pathfinding  
-• Game over modal only appears on maze completion (not on stop)  
-• White time display for better visibility  
-• Difficulty affects maze complexity and time limits
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/sliding-numbers.png" alt="Sliding Numbers" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🔢 Sliding Numbers**  
-Solve the classic 15-puzzle with numbers
-
-• Classic 15-puzzle with numbered tiles  
-• Grid sizes: easy 3x3, medium 4x4, hard 5x5  
-• Timer challenge to solve as fast as possible  
-• Smooth tile sliding animations
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/game-2048.png" alt="2048 Game" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🎮 2048 Game**  
-Merge tiles to reach 2048 and beyond
-
-• Swipe to merge tiles with same numbers  
-• Reach 2048 tile to win, continue for higher scores  
-• Undo moves feature for strategic gameplay  
-• Difficulty affects starting tile values and spawn rate
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-<tr>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/fruit-merger.png" alt="Fruit Merger" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🍉 Fruit Merger**  
-Merge fruits to create bigger ones
-
-• Merge fruits to create bigger ones (watermelon evolution)  
-• Physics-based dropping and merging mechanics  
-• Combo system for multiple merges  
-• Difficulty affects merge requirements and spawn rate
-
-</td>
-</tr>
-</table>
-</td>
-<td width="50%" style="vertical-align: top;">
-<table style="border: none;">
-<tr style="border: none;">
-<td width="120" style="vertical-align: top; border: none;">
-<img src="https://cdn.worklage.com/playtura/screenshots/snake.png" alt="Snake & Eggs" width="100"/>
-</td>
-<td style="vertical-align: top; border: none;">
-
-**🐍 Snake & Eggs**  
-Classic snake game with modern touch controls
-
-• Classic snake gameplay with modern touch controls  
-• Swipe or tap to change direction  
-• Grow by eating food, avoid walls and yourself  
-• Difficulty affects snake speed and grid size
-
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
+| Screenshot | Game Details |
+|------------|--------------|
+| <img src="https://cdn.worklage.com/playtura/screenshots/fruit-ninja.png" alt="Fruit Ninja" width="120"/> | **🍎 Fruit Ninja**<br/>Slice flying fruits with finger swipes - avoid the bombs!<br/><br/>• Fixed 60-second gameplay sessions<br/>• Physics-based slicing with particle effects and combo system<br/>• Difficulty affects fruit spawn rate and bomb frequency |
+| <img src="https://cdn.worklage.com/playtura/screenshots/candy-crush.png" alt="Candy Crush" width="120"/> | **🍬 Candy Crush**<br/>Match colorful candies in this puzzle game<br/><br/>• Match-3 puzzle with colorful candies<br/>• Create special candies with 4+ matches<br/>• Cascading combos and satisfying animations<br/>• Difficulty affects level objectives and move limits |
+| <img src="https://cdn.worklage.com/playtura/screenshots/flappy-bird.png" alt="Flappy Bird" width="120"/> | **🐦 Flappy Bird**<br/>Navigate bird through pipes with precise timing<br/><br/>• Classic tap-to-flap mechanics with gravity physics<br/>• Navigate through pipes with pixel-perfect collision<br/>• Progressive difficulty with increasing pipe speed<br/>• Difficulty affects pipe gap size and spawn frequency |
+| <img src="https://cdn.worklage.com/playtura/screenshots/colors-sort.png" alt="Colors Sort" width="120"/> | **🎨 Colors Sort**<br/>Sort colored liquids into matching tubes<br/><br/>• Sort colored liquids into matching tubes<br/>• Logic puzzle with increasing complexity<br/>• Satisfying pour animations and sound effects<br/>• Difficulty affects number of tubes and colors |
+| <img src="https://cdn.worklage.com/playtura/screenshots/dino-jump.png" alt="Dino Jump" width="120"/> | **🦖 Dino Jump**<br/>Chrome offline dino game - jump to avoid obstacles!<br/><br/>• Endless runner with tap-to-jump mechanics<br/>• Collect stars for extra lives (max 3 lives)<br/>• Game durations: easy 2 mins, medium 3 mins, hard 5 mins<br/>• Dynamic ground height based on device offset (150px or 250px)<br/>• Difficulty affects obstacle spawn rate and game speed |
+| <img src="https://cdn.worklage.com/playtura/screenshots/popit-fidget.png" alt="Popit Fidget" width="120"/> | **🫧 Popit Fidget**<br/>Pop satisfying bubbles in this relaxing fidget toy game<br/><br/>• Relaxing bubble popping with satisfying sound effects<br/>• Different bubble shapes and colors for variety<br/>• Difficulty affects bubble responsiveness and patterns |
+| <img src="https://cdn.worklage.com/playtura/screenshots/whack-a-mole.png" alt="Whack A Mole" width="120"/> | **🐱 Whack A Mole**<br/>Whack cute cats popping from holes - fast reflexes needed!<br/><br/>• Cat spawn intervals: easy 2000ms, medium 1500ms, hard 1000ms<br/>• Cat visible duration: easy 2500ms, medium 2000ms, hard 1500ms<br/>• Grid sizes: easy/medium 3x3, hard 4x4 |
+| <img src="https://cdn.worklage.com/playtura/screenshots/balloon-blaster.png" alt="Balloon Blaster" width="120"/> | **🎈 Balloon Blaster**<br/>Pop rising balloons before they escape - quick taps win!<br/><br/>• Fixed 60-second gameplay sessions<br/>• Balloon spawn interval: 1200ms, rise speed: 0.08<br/>• Physics-based balloon movement with particle effects |
+| <img src="https://cdn.worklage.com/playtura/screenshots/space-fighter.png" alt="Space Fighter" width="120"/> | **🚀 Space Fighter**<br/>Pilot spaceship through asteroid fields in endless space<br/><br/>• Horizontal drag controls with smooth spacecraft movement<br/>• Dynamic spacecraft positioning based on device offset<br/>• Progressive difficulty with asteroid spawn intervals<br/>• 1-second collision immunity after each hit<br/>• Difficulty affects asteroid speed and spawn frequency |
+| <img src="https://cdn.worklage.com/playtura/screenshots/maze-runner.png" alt="Maze Runner" width="120"/> | **🧩 Maze Runner**<br/>Navigate ball through mazes using tilt and physics controls<br/><br/>• Grid sizes: easy 8x8, medium 10x10, hard 12x12<br/>• Procedurally generated mazes with intelligent pathfinding<br/>• Game over modal only appears on maze completion (not on stop)<br/>• White time display for better visibility<br/>• Difficulty affects maze complexity and time limits |
+| <img src="https://cdn.worklage.com/playtura/screenshots/sliding-numbers.png" alt="Sliding Numbers" width="120"/> | **🔢 Sliding Numbers**<br/>Solve the classic 15-puzzle with numbers<br/><br/>• Classic 15-puzzle with numbered tiles<br/>• Grid sizes: easy 3x3, medium 4x4, hard 5x5<br/>• Timer challenge to solve as fast as possible<br/>• Smooth tile sliding animations |
+| <img src="https://cdn.worklage.com/playtura/screenshots/game-2048.png" alt="2048 Game" width="120"/> | **🎮 2048 Game**<br/>Merge tiles to reach 2048 and beyond<br/><br/>• Swipe to merge tiles with same numbers<br/>• Reach 2048 tile to win, continue for higher scores<br/>• Undo moves feature for strategic gameplay<br/>• Difficulty affects starting tile values and spawn rate |
+| <img src="https://cdn.worklage.com/playtura/screenshots/fruit-merger.png" alt="Fruit Merger" width="120"/> | **🍉 Fruit Merger**<br/>Merge fruits to create bigger ones<br/><br/>• Merge fruits to create bigger ones (watermelon evolution)<br/>• Physics-based dropping and merging mechanics<br/>• Combo system for multiple merges<br/>• Difficulty affects merge requirements and spawn rate |
+| <img src="https://cdn.worklage.com/playtura/screenshots/snake.png" alt="Snake & Eggs" width="120"/> | **🐍 Snake & Eggs**<br/>Classic snake game with modern touch controls<br/><br/>• Classic snake gameplay with modern touch controls<br/>• Swipe or tap to change direction<br/>• Grow by eating food, avoid walls and yourself<br/>• Difficulty affects snake speed and grid size |
 
 ## 📦 Installation
 
@@ -389,7 +101,7 @@ Follow the installation guides for each peer dependency:
 - **[react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started)** - Animations
 - **[react-native-gesture-handler](https://docs.swmansion.com/react-native-gesture-handler/docs/fundamentals/installation)** - Gestures
 - **[expo-speech](https://docs.expo.dev/versions/latest/sdk/speech/)** - Sounds
-- **[expo-haptics](https://docs.expo.dev/versions/latest/sdk/haptics/)** - Haptic
+- **[expo-haptics](https://docs.expo.dev/versions/latest/sdk/haptics/)** - Haptics
 
 ## 🚀 Usage
 
@@ -400,14 +112,14 @@ For basic usage without settings persistence:
 ```tsx
 import React, { useState } from 'react';
 import { View } from 'react-native';
-import { DEFAULT_GAME_SETTINGS, BalloonBlaster } from 'react-native-games';
+import { DEFAULT_GAME_SETTINGS, FruitNinja } from 'react-native-games';
 
 export default function GameScreen() {
   const [settings, setSettings] = useState(DEFAULT_GAME_SETTINGS);
 
   return (
     <View style={{ flex: 1 }}>
-      <BalloonBlaster settings={settings} onSettingsChange={setSettings} />
+      <FruitNinja settings={settings} onSettingsChange={setSettings} />
     </View>
   );
 }
@@ -528,20 +240,20 @@ All games use a centralized settings system for consistency and ease of maintena
 import {
   // Game IDs Enum
   GAME_IDS,
-  
+
   // Default Settings
   DEFAULT_GAME_SETTINGS,
-  
+
   // Games List & Mapping
   GAMES_LIST,
   GAMES_MAPPING,
-  
+
   // TypeScript Types
   type GameSettings,
   type GameProps,
   type GameDefinition,
   type GameComponent,
-  
+
   // All Game Components
   FruitNinja,
   CandyCrush,