Social Quest RPG

A mobile social role-playing game built with React Native and Expo, featuring quest-based gameplay, social interactions, and immersive storytelling.

🎮 Features

• Quest System: Dynamic quest generation and progression
• Social Interactions: Connect with other players and NPCs
• Character Customization: Build and evolve your character
• Real-time Updates: Live notifications and social features
• Cross-platform: Works on iOS and Android

🚀 Quick Start

Prerequisites

• Node.js (v16 or higher)
• Expo CLI
• iOS Simulator or physical device

Installation

1. Clone the repository

   git clone https://github.com/yourusername/geme.git
   cd geme

2. Install dependencies

   npm install

3. Start the development server

   npm start

4. Run on device/simulator

   • Scan the QR code with Expo Go app
   • Or press 'i' for iOS simulator
   • Or press 'a' for Android emulator

📱 Building for Production

iOS Build

Follow the detailed steps in QUICK_BUILD_STEPS.md

eas build --profile development --platform ios

Android Build

eas build --profile development --platform android

📁 Project Structure

social-rpg/
├── app/                 # Main app screens and navigation
├── components/          # Reusable UI components
├── systems/            # Game systems (quests, combat, etc.)
├── stores/             # State management
├── data/               # Game data and configurations
├── assets/             # Images, audio, and other assets
├── utils/              # Utility functions
├── types/              # TypeScript type definitions
└── constants/          # App constants and configurations

🛠️ Development

Key Technologies

• React Native: Mobile app framework
• Expo: Development platform and build service
• TypeScript: Type-safe JavaScript
• Zustand: State management
• React Navigation: Screen navigation

Available Scripts

• npm start: Start the development server
• npm run ios: Run on iOS simulator
• npm run android: Run on Android emulator
• npm run web: Run on web browser
• eas build: Build for production

📚 Documentation

• Quick Build Steps - Fast setup for iPhone
• Build Guide - Detailed build instructions
• Build Checklist - Pre-build verification
• Assets Reference - Asset management guide
• Tileset Download Guide - Game assets setup

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

If you encounter any issues:

1. Check the Build Checklist
2. Review the Build Guide
3. Open an issue on GitHub

---

Happy Questing! 🗡️✨