AI-powered game creation platform - Create professional mobile games, VR experiences, and educational content with zero coding required.

• 🎨 15 Complete Game Templates - Ready-to-use templates across all genres
• 🤖 Genie AI Assistant - 4 specialized AI personalities to guide you
• 🎭 5 Signature Art Styles - Professional visual themes for your games
• 🥽 VR/AR Support - Create immersive experiences for Quest, PSVR, and WebXR
• 📊 Marketing Automation - Built-in tools for promotion and analytics
• 🚀 Multi-Platform Export - Deploy to iOS, Android, and Web

• Pixi.js - High-performance 2D rendering
• Babylon.js - Advanced 3D graphics and physics
• A-Frame - VR/AR experiences with WebXR

1. Creative Mentor 🎨 - Game design & storytelling guidance
2. Technical Expert ⚙️ - Implementation & optimization help
3. Marketing Guru 📈 - Promotion & monetization strategies
4. Educator 📚 - Teaching-focused content creation

1. Puzzle Match-3 - Classic gem-matching mechanics
2. Endless Runner - Side-scrolling action
3. Tower Defense - Strategic gameplay
4. Platformer - Jump and run adventure
5. Quiz/Trivia - Educational questions
6. Card Game - Deck building mechanics
7. Idle Clicker - Incremental progression
8. Rhythm Game - Music-based gameplay
9. Interactive Story - Choose-your-own-adventure

10. Racing Game - 3D tracks and vehicles
11. Physics Puzzle - Realistic physics challenges

12. VR Escape Room - Immersive puzzle solving
13. AR Treasure Hunt - Location-based gameplay
14. Virtual Museum - Educational VR tours
15. Shooting Gallery - VR target practice

1. Pixel Perfect 🕹️ - Retro pixel art
2. Low Poly 3D 🔷 - Minimalist 3D aesthetic
3. Hand-Drawn ✏️ - Sketch/cartoon style
4. Neon Cyberpunk 🌃 - Futuristic glowing effects
5. Watercolor Dreams 🎨 - Soft artistic rendering

• Node.js 16+ and npm/yarn
• Expo CLI (npm install -g expo-cli)
• iOS Simulator (Mac) or Android Studio

# Clone the repository
git clone https://github.com/ismaelloveexcel/gameforge-mobile.git
cd gameforge-mobile

# Install dependencies
npm install

# Start the development server
npm start

# Run on iOS (Mac only)
npm run ios

# Run on Android
npm run android

# Run on Web
npm run web

• Getting Started Guide
• Template Documentation
• Genie AI Guide
• Art Styles Guide
• Marketing Automation
• VR Development
• API Reference

• ⚡ Fastest Deploy (2 min) - Just 2 steps, zero accounts needed ⭐ RECOMMENDED!
• GitHub Actions Automated Deployment - CI/CD with GitHub Actions
• Deployment Summary - Quick overview
• Free Deployment Recommendation - Complete guide
• Quick Deploy Guide - Deploy in under 2 minutes
• Platform Comparison - 8 platforms analyzed
• Full Deployment Guide - All deployment options

gameforge-mobile/
├── src/
│   ├── components/       # Reusable UI components
│   ├── contexts/         # React contexts (Theme, Genie)
│   ├── engines/          # Game engine implementations
│   │   ├── PixiEngine.ts      # Pixi.js 2D engine
│   │   ├── BabylonEngine.ts   # Babylon.js 3D engine
│   │   └── AFrameEngine.ts    # A-Frame VR/AR engine
│   ├── navigation/       # App navigation setup
│   ├── screens/          # App screens
│   ├── services/         # Business logic services
│   │   ├── GenieService.ts        # AI assistant
│   │   ├── TemplateLibrary.ts     # Game templates
│   │   ├── ArtStyleService.ts     # Art styles
│   │   └── MarketingService.ts    # Marketing tools
│   ├── styles/           # Shared styles
│   ├── types/            # TypeScript types
│   └── utils/            # Utility functions
├── assets/               # Images, fonts, etc.
├── docs/                 # Documentation
├── App.tsx               # Root component
└── package.json          # Dependencies

import { templateLibrary } from './services/TemplateLibrary';
import { EngineFactory } from './engines/IGameEngine';

// 1. Select a template
const template = templateLibrary.getTemplateById('match3');

// 2. Create engine instance
const engine = await EngineFactory.createEngine('pixi');

// 3. Initialize engine
await engine.initialize(container);

// 4. Load template scene
await engine.loadScene(template.data.scenes[0]);

// 5. Start creating!

import { useGenie } from './contexts/GenieContext';

function MyComponent() {
  const { personality, setPersonality, sendMessage } = useGenie();
  
  // Switch to Creative Mentor
  setPersonality('creative');
  
  // Ask for help
  await sendMessage('How do I create an engaging story?');
}

import { artStyleService } from './services/ArtStyleService';

// Get all available styles
const styles = artStyleService.getAllStyles();

// Apply a style to your game
artStyleService.applyStyleToEngine('pixel', engine);

// Get color palette
const colors = artStyleService.getStyleColors('cyberpunk');

import { marketingService } from './services/MarketingService';

// Create campaign
const campaign = marketingService.createCampaign(projectId, 'social');

// Generate promotional content
const content = await marketingService.generatePromotionalContent(
  'My Game',
  'puzzle',
  ['match-3', 'power-ups', 'leaderboards']
);

// Get analytics
const dashboard = marketingService.getAnalyticsDashboard(projectId);

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Run linter
npm run lint

# Build for web
npm run build:web

# Build for iOS
npm run build:ios

# Build for Android
npm run build:android

GameForge Mobile is deployed using GitHub Pages - a free static site hosting service integrated directly into GitHub!

What you get:

• ✅ Automatic web deployment to GitHub Pages on every push to main
• ✅ 100% FREE hosting for public repositories
• ��� Built-in GitHub integration - no external services needed
• ✅ Continuous integration with linting and testing
• ✅ Global CDN for fast loading worldwide

How it works:

1. Push your changes to the main branch
2. GitHub Actions automatically builds the web app
3. The build is deployed to GitHub Pages
4. Your app is live at https://ismaelloveexcel.github.io/GameDevelopmentHub/

Quick Setup:

1. Go to your repository Settings → Pages
2. Set Source to "GitHub Actions"
3. Push to main branch
4. Watch automated deployments at https://github.com/ismaelloveexcel/GameDevelopmentHub/actions

📖 Complete GitHub Actions Setup Guide

For manual deployments or testing, the GitHub Actions workflow handles everything automatically. Simply:

Quick Deploy:

# Just push to main - deployment is automatic!
git push origin main

# For Android APK (Free with EAS)
eas build --platform android --profile production

Why GitHub Pages?

• ✅ 100% Free for public repositories
• ✅ Integrated with GitHub - no external accounts needed
• ✅ Automatic CI/CD from GitHub Actions
• ✅ Global CDN for fast loading
• ✅ Custom domain support
• ✅ HTTPS by default

See detailed guides:

• 🤖 GitHub Actions Deployment - Automated CI/CD setup
• 📘 Free Deployment Recommendation - Complete platform comparison
• ⚡ Quick Deploy Guide - Deploy in 10 minutes
• 📖 Full Deployment Guide - All deployment options

This project also supports deployment on GitHub Spark. The spark.yaml configuration file is included in the repository root.

1. Navigate to your repository on GitHub
2. Access the Spark interface
3. GitHub Spark will automatically detect the configuration and deploy your app

We welcome contributions! Please see our Contributing Guide for details.

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

• Built with React Native and Expo
• 2D rendering by Pixi.js
• 3D graphics by Babylon.js
• VR/AR powered by A-Frame

• 📧 Email: support@gameforge.mobile
• 💬 Discord: Join our community
• 📖 Docs: docs.gameforge.mobile
• 🐛 Issues: GitHub Issues

Made with ❤️ by the GameForge Team

Create games, not code.