Stack-Tower

Stack Master

A highly addictive, production-ready stacking game built with Expo for iOS and Android.

🎮 Game Overview

Stack Master is a precision stacking game where you tap to drop moving blocks and build the tallest tower possible. Perfect placements earn bonus points and combos!

Psychological Hooks (What Makes It Addictive)

Variable Reward Schedule: Random “perfect” and “good” messages, combo multipliers
Near-Miss Effect: Close placements feel rewarding even when not perfect
Progress & Achievement: Score tracking, milestones, combo system
Social Comparison: Share scores, compete with yourself
Loss Aversion: Want to protect your high score
Flow State: Increasing difficulty keeps you in the zone
Short Sessions: Quick games encourage “one more try”
Daily Challenges: Return daily to complete new challenges

🚀 Getting Started

Prerequisites

Node.js 18+
npm or yarn
Expo CLI
iOS Simulator (Mac) or Android Studio

Installation

# Install dependencies
npm install

# Start the development server
npx expo start

Running on Device/Simulator

# iOS
npx expo run:ios

# Android  
npx expo run:android

📱 Building for Production

Using EAS Build (Recommended)

# Install EAS CLI
npm install -g eas-cli

# Login to Expo
eas login

# Configure your project
eas build:configure

# Build for iOS
eas build --platform ios

# Build for Android
eas build --platform android

Local Build

# iOS (requires Mac)
npx expo run:ios --configuration Release

# Android
npx expo run:android --variant release

🎯 Game Features

Smooth 60fps Animations: Using React Native Reanimated
Haptic Feedback: Satisfying touch responses
Beautiful UI/UX: Modern gradient design with particle effects
Persistent Storage: High scores saved locally
Performance Optimized: Efficient rendering and memory management
Cross-Platform: Works on iOS and Android

📁 Project Structure

src/
├── components/      # Reusable UI components
│   ├── Block.tsx
│   ├── FallingPiece.tsx
│   ├── ComboIndicator.tsx
│   ├── ParticleEffect.tsx
│   └── ...
├── screens/         # Main screens
│   ├── HomeScreen.tsx
│   ├── GameScreen.tsx
│   └── GameOverScreen.tsx
├── hooks/           # Custom React hooks
│   └── useGame.ts
├── utils/           # Utility functions
│   ├── gameLogic.ts
│   ├── storage.ts
│   └── audio.ts
├── constants/       # Game configuration
│   └── index.ts
└── types/           # TypeScript types
    └── index.ts

⚙️ Configuration

Game settings can be adjusted in src/constants/index.ts:

INITIAL_BLOCK_WIDTH: Starting block width
INITIAL_SPEED: Starting movement speed
SPEED_INCREMENT: Speed increase per level
PERFECT_THRESHOLD: Pixel tolerance for perfect placement
COMBO_THRESHOLD: Combo activation threshold

🎨 Customization

Colors

Modify COLORS in src/constants/index.ts to change the game’s color scheme.

Block Colors

Update blockColors array for different block appearances.

📊 Performance

Blocks outside viewport are not rendered
Uses React.memo for component optimization
Reanimated worklets run on UI thread
Efficient state management

📄 License

MIT License - feel free to use this for your own projects!

🙏 Credits

Inspired by classic stacking games. Built with: