Skip to content

Logic-based Bulls & Cows game built with React Native, featuring AI gameplay, energy system, Firebase sync, and custom Google Play Games integration.

Notifications You must be signed in to change notification settings

Zyrab/numbero10

Repository files navigation

Numbero - A Logic Puzzle

Published Mobile Game (React Native, Expo)
Google Play: https://play.google.com/store/apps/details?id=com.anonymous.Numbero10

Numbero is a simple but polished logic game inspired by Bulls & Cows. Players guess numbers against an AI with points, energy, and rankings, designed for fast and engaging gameplay with clear rules and statistics.


Overview

Numbero focuses on clean gameplay, simple animations, and meaningful progression. Key design principles:

  • Easy-to-understand mechanics with neobrutalism-inspired UI
  • Offline-capable single-player AI mode
  • Energy system: 1 game = 1 energy, refill via reward ads or coins
  • Coins earned based on performance: attempts, time, number length, and AI victory bonus
  • Ranking points synced with Google Play Games Services
  • In-game guide and tutorial explaining rules, strategy, and keyboard mechanics

Planned enhancements include multiplayer rounds, puzzle/campaign mode, hints, and improved tutorial.


Tech Stack

Mobile Development

  • React Native, Expo
  • React Context API
  • React Native Animated
  • Custom Expo Native Modules

Authentication & Platform Services

  • Firebase Authentication
  • Google Play Games Services (GPGS)
  • No-click sign-in via GPGS integrated with Firebase Auth
  • Custom native module implementation for GPGS (since no official React Native support)

Backend

  • Firestore (client-based stats and progression storage)

Monetization

  • AdMob rewarded ads

Deployment

  • Google Play Store
  • EAS Build (AAB generation)

Features

Gameplay

  • Single-player AI with adjustable difficulty
  • Track statistics: win/loss/draw ratio, average attempts, best time
  • Local save for continuing previous games without spending energy

Progression & Rewards

  • Energy system to limit plays per session
  • Coins earned based on performance
  • Shop for themes and energy purchase
  • Planned hints system

Rankings

  • Points awarded based on game performance
  • Leaderboards via Google Play Games Services

Design

  • Neobrutalism-style interface
  • Clean, simple animations with React Native Animated
  • Clear tutorials and strategy guides

Architecture Highlights

  • Modular React Native structure
  • Context API for global state management
  • Offline-first experience
  • Simple, maintainable code — no unnecessary complexity
  • Light Firebase usage for stats and authentication
  • Implemented custom Expo native module for Google Play Games Services integration
  • Modified native Android configuration via Expo config plugin to install and configure GPGS dependencies
  • Enabled no-click GPGS authentication synchronized with Firebase Auth
  • Exposed native leaderboard and ranking APIs to React Native layer

Local Development

git clone https://github.com/Zyrab/numbero10

pnpm install

npx expo start

Requires Firebase config for Auth and Firestore.


Status

  • Published on Play Store with 100+ installs
  • Offline AI mode fully functional
  • Multiplayer and campaign modes planned
  • Active development on enhancements when time allows

About

Logic-based Bulls & Cows game built with React Native, featuring AI gameplay, energy system, Firebase sync, and custom Google Play Games integration.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors