react-native-games 0.8.0 → 1.0.0

package/README.md

@@ -1,25 +1,369 @@
 # 🎮 react-native-games
 
-**react-native-games** is a collection of free, 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.
+**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>
 
 ## 🎯 Available Games
 
-| Game                   | Description | Features |
-|------------------------|-------------|----------|
-| **🐱 Whack A Mole**    | Whack cute cats popping from holes - fast reflexes needed! | Multiple difficulty levels, customizable grid sizes, haptic feedback |
-| **🫧 Popit Fidget**    | Pop satisfying bubbles in this relaxing fidget toy game | Relaxing gameplay, colorful bubbles, different shapes |
-| **🍎 Fruit Ninja**     | Slice flying fruits with finger swipes - avoid the bombs! | Physics-based slicing, particle effects, combo system |
-| **🧩 Maze Runner**     | Navigate ball through mazes using tilt and physics controls | Dynamic maze generation, physics controls, multiple difficulties |
-| **🚀 Space Fighter**   | Pilot spaceship through asteroid fields in endless space | 3D-style graphics, progressive difficulty, space physics |
-| **🎈 Balloon Blaster** | Pop rising balloons before they escape - quick taps win! | Physics-based gameplay, particle effects, combo system |
-| **🦖 Dino Jump**       | Jump over cacti and collect stars in endless desert run | Tap to jump, collect stars for extra lives, progressive difficulty |
-| **🐦 Flappy Bird**     | Navigate bird through pipes with precise timing | Classic flappy mechanics, pixel-perfect collision, addictive gameplay |
-| **🐍 Snake Game**      | Classic snake game with modern touch controls | Grow by eating food, avoid walls and yourself, smooth controls |
-| **🎮 2048 Game**       | Merge tiles to reach 2048 and beyond | Swipe to merge, strategic gameplay, undo moves |
-| **🔢 Sliding Numbers** | Solve the classic 15-puzzle with numbers | Multiple grid sizes, timer challenge, smooth animations |
-| **🍬 Candy Crush**     | Match colorful candies in this puzzle game | Match-3 mechanics, special candies, cascading combos |
-| **🎨 Color Sort**      | Sort colored liquids into matching tubes | Logic puzzle, satisfying pour animations, increasing difficulty |
-| **🍉 Fruit Merger**    | Merge fruits to create bigger ones | Physics-based merging, watermelon evolution, combo system |
+<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>
 
 ## 📦 Installation
 
@@ -41,12 +385,11 @@ npm install @shopify/react-native-skia react-native-reanimated react-native-gest
 
 Follow the installation guides for each peer dependency:
 
-- **[@shopify/react-native-skia](https://shopify.github.io/react-native-skia/docs/getting-started/installation)** - Graphics rendering
+- **[@shopify/react-native-skia](https://shopify.github.io/react-native-skia/docs/getting-started/installation)** - Graphics
 - **[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
-- **[react-native-worklets](https://github.com/margelo/react-native-worklets)** - Worklets for high-performance animations
-- **[expo-speech](https://docs.expo.dev/versions/latest/sdk/speech/)** - Text-to-speech functionality
-- **[expo-haptics](https://docs.expo.dev/versions/latest/sdk/haptics/)** - Haptic feedback
+- **[expo-speech](https://docs.expo.dev/versions/latest/sdk/speech/)** - Sounds
+- **[expo-haptics](https://docs.expo.dev/versions/latest/sdk/haptics/)** - Haptic
 
 ## 🚀 Usage
 
@@ -122,20 +465,20 @@ All games use the same props interface:
 ```tsx
 // Import any game you want
 import {
-  WhackAMole,
-  PopitFidget,
   FruitNinja,
-  MazeRunner,
-  SpaceFighter,
-  BalloonBlaster,
-  DinoJump,
+  CandyCrush,
   FlappyBird,
-  Snake,
-  Game2048,
+  ColorsSort,
+  DinoJump,
+  PopitFidget,
+  WhackAMole,
+  BalloonBlaster,
+  SpaceFighter,
+  MazeRunner,
   SlidingNumbers,
-  CandyCrush,
-  ColorSort,
-  FruitMerger
+  Game2048,
+  FruitMerger,
+  Snake
 } from 'react-native-games';
 
 // All games accept the same props:
@@ -163,89 +506,10 @@ const DEFAULT_GAME_SETTINGS = {
   difficulty: 'medium',
   enableSounds: true,
   enableHaptics: true,
+  offset: 0,
 };
 ```
 
-#### Game-Specific Behaviors
-
-**Whack A Mole**
-- 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
-
-**Popit Fidget**
-- Relaxing bubble popping with satisfying sound effects
-- Different bubble shapes and colors for variety
-- Difficulty affects bubble responsiveness and patterns
-
-**Fruit Ninja**
-- Fixed 60-second gameplay sessions
-- Physics-based slicing with particle effects and combo system
-- Difficulty affects fruit spawn rate and bomb frequency
-
-**Space Fighter**
-- Progressive difficulty with asteroid spawn intervals
-- Horizontal drag controls with collision immunity system
-- Difficulty affects asteroid speed and spawn frequency
-
-**Maze Runner**
-- Grid sizes: easy 8x8, medium 10x10, hard 12x12
-- Procedurally generated mazes with intelligent pathfinding
-- Difficulty affects maze complexity and time limits
-
-**Balloon Blaster**
-- Fixed 60-second gameplay sessions
-- Balloon spawn interval: 1200ms, rise speed: 0.08
-- Physics-based balloon movement with particle effects
-
-**Dino Jump**
-- Endless runner with tap-to-jump mechanics
-- Collect stars for extra lives (max 3 lives)
-- Progressive difficulty with increasing speed
-- Difficulty affects obstacle spawn rate and game speed
-
-**Flappy Bird**
-- 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
-
-**Snake**
-- 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
-
-**Game 2048**
-- 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
-
-**Sliding 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
-
-**Candy Crush**
-- Match-3 puzzle with colorful candies
-- Create special candies with 4+ matches
-- Cascading combos and satisfying animations
-- Difficulty affects level objectives and move limits
-
-**Color Sort**
-- Sort colored liquids into matching tubes
-- Logic puzzle with increasing complexity
-- Satisfying pour animations and sound effects
-- Difficulty affects number of tubes and colors
-
-**Fruit Merger**
-- 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
-
 ### Game Settings
 
 Each game includes built-in settings screens with a unified, simplified interface:
@@ -258,48 +522,112 @@ All games use a centralized settings system for consistency and ease of maintena
 
 ## 📚 API Reference
 
-### GamesService
-
-Core game configuration and settings management.
+### Exported Constants & Types
 
 ```tsx
 import {
+  // Game IDs Enum
   GAME_IDS,
+  
+  // Default Settings
   DEFAULT_GAME_SETTINGS,
-  gamesList,
+  
+  // Games List & Mapping
+  GAMES_LIST,
+  GAMES_MAPPING,
+  
+  // TypeScript Types
   type GameSettings,
-  type GameProps
+  type GameProps,
+  type GameDefinition,
+  type GameComponent,
+  
+  // All Game Components
+  FruitNinja,
+  CandyCrush,
+  FlappyBird,
+  ColorsSort,
+  DinoJump,
+  PopitFidget,
+  WhackAMole,
+  BalloonBlaster,
+  SpaceFighter,
+  MazeRunner,
+  SlidingNumbers,
+  Game2048,
+  FruitMerger,
+  Snake
 } from 'react-native-games';
+```
+
+### GAME_IDS Enum
+
+All available game identifiers:
+
+```tsx
+GAME_IDS.FRUIT_NINJA      // 'fruit-ninja'
+GAME_IDS.CANDY_CRUSH      // 'candy-crush'
+GAME_IDS.FLAPPY_BIRD      // 'flappy-bird'
+GAME_IDS.COLORS_SORT      // 'colors-sort'
+GAME_IDS.DINO_JUMP        // 'dino-jump'
+GAME_IDS.POPIT_FIDGET     // 'popit-fidget'
+GAME_IDS.WHACK_A_MOLE     // 'whack-a-mole'
+GAME_IDS.BALLOON_BLASTER  // 'balloon-blaster'
+GAME_IDS.SPACE_FIGHTER    // 'space-fighter'
+GAME_IDS.MAZE_RUNNER      // 'maze-runner'
+GAME_IDS.SLIDING_NUMBERS  // 'sliding-numbers'
+GAME_IDS.GAME_2048        // 'game-2048'
+GAME_IDS.FRUIT_MERGER     // 'fruit-merger'
+GAME_IDS.SNAKE            // 'snake'
+```
+
+### DEFAULT_GAME_SETTINGS
+
+Default configuration for all games:
+
+```tsx
+const DEFAULT_GAME_SETTINGS = {
+  isVisible: false,      // Settings modal visibility
+  difficulty: 'medium',  // Game difficulty level
+  enableSounds: true,    // Audio feedback enabled
+  enableHaptics: true,   // Haptic feedback enabled
+  offset: 0,            // Top offset for notch/status bar
+};
+
+// Example: Custom settings with offset
+const customSettings = {
+  ...DEFAULT_GAME_SETTINGS,
+  offset: 50,  // Moves game elements 50px down from top
+};
+```
+
+### GAMES_LIST
 
-// Game IDs enum for all available games
-GAME_IDS.WHACK_A_MOLE
-GAME_IDS.POPIT_FIDGET
-GAME_IDS.FRUIT_NINJA
-GAME_IDS.BALLOON_BLASTER
-GAME_IDS.SPACE_FIGHTER
-GAME_IDS.MAZE_RUNNER
-GAME_IDS.SLIDING_NUMBERS
-GAME_IDS.GAME_2048
-GAME_IDS.DINO_JUMP
-GAME_IDS.COLOR_SORT
-GAME_IDS.FRUIT_MERGER
-GAME_IDS.FLAPPY_BIRD
-GAME_IDS.CANDY_CRUSH
-GAME_IDS.SNAKE
-
-// Default game settings
-const settings = DEFAULT_GAME_SETTINGS;
-// {
-//   isVisible: false,
-//   difficulty: 'medium',
-//   enableSounds: true,
-//   enableHaptics: true
-// }
-
-// Games list with metadata
-gamesList.forEach(game => {
-  console.log(game.id, game.title, game.description);
+Array of all game definitions with metadata:
+
+```tsx
+// GAMES_LIST is an array of GameDefinition objects
+GAMES_LIST.forEach(game => {
+  console.log(game.id);          // GAME_IDS enum value
+  console.log(game.title);       // Display title
+  console.log(game.description); // Game description
+  console.log(game.component);   // React component
 });
+
+// Example: Find a specific game
+const fruitNinja = GAMES_LIST.find(g => g.id === GAME_IDS.FRUIT_NINJA);
+```
+
+### GAMES_MAPPING
+
+Object mapping game IDs to their components:
+
+```tsx
+// Access game component by ID
+const GameComponent = GAMES_MAPPING[GAME_IDS.FRUIT_NINJA];
+
+// Render dynamically
+<GameComponent settings={settings} onSettingsChange={handleChange} />
 ```
 
 ### TypeScript Types
@@ -311,6 +639,7 @@ interface GameSettings {
   difficulty: 'easy' | 'medium' | 'hard';
   enableSounds: boolean;     // Audio feedback
   enableHaptics: boolean;    // Haptic feedback
+  offset?: number;           // Optional padding from top (default: 0)
 }
 
 // Game component props
@@ -320,37 +649,6 @@ interface GameProps {
 }
 ```
 
-## 🎨 Features
-
-### 🚀 **High Performance**
-- Built with React Native Skia for 60fps gameplay
-- Optimized animations using Reanimated 3 with worklets
-- Delta time physics loops for consistent performance
-- React.memo optimizations and efficient state management
-- Minimal re-renders with direct store subscriptions
-
-### 🎵 **Rich Audio & Haptics**
-- Sound effects and speech synthesis
-- Haptic feedback for immersive experience
-- Configurable audio settings
-
-### 🎯 **Customizable**
-- Multiple difficulty levels
-- Adjustable game parameters
-- Persistent settings storage
-
-### 📱 **Cross-Platform**
-- iOS and Android support
-- Consistent performance across devices
-- Responsive design for different screen sizes
-
-### 🎮 **Game Features**
-- **Physics Simulation**: Realistic movement and collisions
-- **Particle Systems**: Visual effects and animations
-- **Procedural Generation**: Dynamic content (mazes, obstacles)
-- **Score Systems**: Leaderboards and achievements
-- **Progressive Difficulty**: Adaptive challenge levels
-
 ## 📄 License
 
 This library is available under a **dual licensing model**: