-
-
loading screen
-
signin screen
-
home screen
-
game guide
-
game board
-
celebrations
-
levels
-
Notification: onesignal
-
board thems
-
settings
-
profile
-
achivements
-
App icon
💡 Inspiration
We wanted to build a puzzle game that is simple to understand, difficult to master, and rewarding to return to every day.
🔢 The Core Idea
The idea behind Numpath Puzzle is simple:
🔗 Connect the Numbers. 🧩 Find the Path. 🏆 Beat the Puzzle.
But instead of making another casual puzzle game that ends after a few levels, we designed Numpath Puzzle around:
- 🧠 Progression
- 🎯 Mastery
- 🔥 Daily Streaks
- 💡 Hints
- 📅 Daily Challenges
- 🏆 Rewards
- ♾️ Long-Term Engagement
❓ Our Biggest Design Question
How can a small puzzle game feel like a complete game ecosystem rather than just a collection of levels?
That question shaped the entire architecture of Numpath Puzzle.
Instead of treating gameplay, progression, and engagement as separate features, we designed them as three interconnected systems that continuously reinforce each other.
🏗️ NUMPATH PUZZLE — GAME ECOSYSTEM
┌───────────────────────────┐
│ 🧩 NUMPATH PUZZLE │
│ Brain + Strategy │
└─────────────┬─────────────┘
│
┌──────────────────────────┼──────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 🎮 GAMEPLAY │ │ 📈 PROGRESSION │ │ 🔥 ENGAGEMENT │
├─────────────────┤ ├─────────────────┤ ├─────────────────┤
│ 🧩 Puzzles │ │ 🎯 Levels │ │ 🔥 Streaks │
│ 💡 Hints │ │ 🎁 Rewards │ │ 📅 Daily Puzzles│
│ ⏱️ Timer │ │ 🏆 Trophy Room │ │ 🔔 Reminders │
│ 🧠 Strategy │ │ ⭐ Achievements │ │ 📊 Challenges │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
└──────────────────────────┼──────────────────────────┘
│
▼
┌───────────────────────────┐
│ ♾️ LONG-TERM PLAY │
├───────────────────────────┤
│ │
│ 🎮 Play → 📈 Progress │
│ → 🔥 Return → 🧠 Master │
│ → 🔁 Repeat │
│ │
└───────────────────────────┘
We then built the monetization and engagement infrastructure around that gameplay instead of interrupting it.
🎮 What It Does
Numpath Puzzle is a minimalist path-finding brain game where players solve increasingly challenging number-grid puzzles.
The game combines logic, spatial reasoning, progression, and daily challenges into a simple gameplay loop that gradually becomes more difficult as players improve.
🧩 The Core Gameplay Loop
The experience is built around a simple cycle:
┌─────────────────┐
│ 🚀 START GAME │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 🧩 CHOOSE │
│ PUZZLE │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 🔍 FIND THE │
│ PATH │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 🔢 CONNECT │
│ NUMBERS │
└────────┬────────┘
│
▼
┌─────────────────┐
│ 🎉 PUZZLE │
│ SOLVED! │
└────────┬────────┘
│
┌────────────┴────────────┐
│ │
▼ ▼
┌──────────────┐ ┌──────────────┐
│ 📈 PROGRESS │ │ 🔥 STREAK │
└───────┬──────┘ └───────┬──────┘
│ │
└────────────┬────────────┘
│
▼
┌─────────────────┐
│ 🧠 MORE │
│ CHALLENGING │
│ PUZZLES │
└────────┬────────┘
│
▼
🔁 REPEAT
✨ What Players Can Do
🧠 Challenge Their Brain
- 🎯 Campaign Levels — Progress through increasingly difficult puzzles.
- 📅 Daily Puzzles — Return every day for a fresh challenge.
- ⏱️ Timed Challenges — Test speed and accuracy under pressure.
- 💡 Hints — Get help when a puzzle becomes difficult.
- ↩️ Undo & Reset — Experiment freely without losing progress.
📈 Track Progress & Mastery
- 📊 Progress Tracking — See how far you have progressed.
- 🔥 Streaks — Build consistency by solving puzzles every day.
- 🏆 Trophy Achievements — Earn achievements as you reach milestones.
💎 Free & Pro Experience
- 🆓 Free Gameplay — Play with an ad-supported experience.
- 💎 Pro Gameplay — Unlock the premium experience through Pro access.
- 🎬 Rewarded Video Hints — Watch an optional video to receive additional hints.
- 📺 Ad-Supported Gameplay — Keep the core game accessible for free players.
- 💳 Monthly & Yearly Pro Subscriptions — Choose a subscription that fits your play style.
🔔 Smart Engagement
- 🔔 Personalized Push Notifications — Receive relevant reminders and challenges.
- 🎯 Deep-Linked Notifications — Tap a notification and jump directly to the relevant part of the game.
🔄 The Result
All of these systems work together to create one simple loop:
🎮 Play → 🧩 Solve → 📈 Progress → 🔥 Return → 🧠 Master
The goal is not just to give players more puzzles, but to create a game that gives them a reason to keep improving, maintain their streak, and come back for the next challenge.
🛠️ How We Built It
Numpath Puzzle was built using Flutter + Riverpod, with Supabase handling authentication and backend data, while Google Play powers the Android distribution and billing ecosystem.
Our architecture was designed to keep gameplay, player data, monetization, and engagement modular while allowing them to work together as one system.
🏗️ Complete Architecture
┌─────────────────────────────┐
│ 🧩 NUMPATH PUZZLE │
│ Flutter + Riverpod │
└──────────────┬──────────────┘
│
┌───────────────────────────────┼───────────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐
│ 🎮 GAMEPLAY │ │ 👤 PLAYER │ │ 💰 MONETIZATION │
├───────────────────┤ ├───────────────────┤ ├───────────────────┤
│ 🧩 Puzzle Engine │ │ 🔐 Authentication │ │ 💎 Pro Access │
│ ⏱️ Timer │ │ 📊 Progress │ │ 💳 Subscriptions │
│ 💡 Hints │ │ 🔥 Streaks │ │ 📺 Rewarded Ads │
│ ↩️ Undo / Reset │ │ 🏆 Achievements │ │ │
└─────────┬─────────┘ └─────────┬─────────┘ └─────────┬─────────┘
│ │ │
└──────────────────────────────┼──────────────────────────────┘
│
▼
┌─────────────────────────────┐
│ ☁️ SUPABASE │
├─────────────────────────────┤
│ 🔐 Auth │
│ 💾 Player Data │
│ 📈 Progress & Streaks │
│ 🎯 Player State │
└──────────────┬──────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 🔔 ONESIGNAL │ │ 💎 REVENUECAT │ │ 📺 ADMOB │
│ Engagement │ │ Subscriptions │ │ Monetization │
├─────────────────┤ ├─────────────────┤ ├─────────────────┤
│ 📲 Push Alerts │ │ 💳 Monthly │ │ 🎬 Rewarded Ads │
│ 🎯 Segments │ │ 💳 Annual │ │ 📺 Ad Breaks │
│ 🔗 Deep Links │ │ 🔑 Entitlement │ │ 🆓 Free Players │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 🎯 SMART │ │ 💎 NUMPATH_PRO │ │ 🆓 FREE PLAYER │
│ ENGAGEMENT │ │ ENTITLEMENT │ │ EXPERIENCE │
├─────────────────┤ ├─────────────────┤ ├─────────────────┤
│ Daily Puzzle │ │ ∞ Unlimited │ │ 📺 Ads │
│ Streak Saver │ │ Hints │ │ 💡 Rewarded │
│ Win-Back │ │ 🚫 No Ads │ │ Hints │
│ Level Updates │ │ 🔓 Full Access │ │ 🎮 Core Game │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
└────────────────────────┼────────────────────────┘
│
▼
┌─────────────────────────────┐
│ 🔁 PLAYER LOOP │
├─────────────────────────────┤
│ │
│ 🎮 Play │
│ ↓ │
│ 🧩 Solve │
│ ↓ │
│ 📈 Progress │
│ ↓ │
│ 🔥 Return │
│ ↓ │
│ 🧠 Master │
│ ↓ │
│ 🔁 Repeat │
│ │
└─────────────────────────────┘
💎 RevenueCat + Google Play
We use RevenueCat as the subscription and entitlement layer rather than managing subscription state separately inside the application.
Both monthly and annual Google Play subscriptions connect to a shared numpath_pro entitlement:
📱 GOOGLE PLAY
│
┌─────────┴─────────┐
▼ ▼
💳 Monthly 💳 Annual
Subscription Subscription
│ │
└─────────┬─────────┘
▼
💎 REVENUECAT
│
▼
🔑 numpath_pro
│
▼
🧩 FLUTTER APP
│
▼
💎 PRO USER
┌──────┴──────┐
│ │
∞ Hints 🚫 Ads
This allows the application to check a single entitlement instead of hard-coding individual store products throughout the game.
📺 AdMob Monetization
We designed advertising around the gameplay rather than allowing ads to interrupt the core puzzle experience.
🆓 FREE PLAYER
│
┌──────────┴──────────┐
▼ ▼
🎮 NORMAL PLAY 💡 NEED HINT?
│ │
│ ▼
│ 📺 REWARDED AD
│ AdMob
│ │
│ ▼
│ 🎁 +1 HINT
│
▼
📺 NATURAL AD BREAK
Rewarded ads are opt-in. Players can voluntarily watch an ad when they need another hint, keeping the core gameplay uninterrupted.
Pro players get an ad-free experience with unlimited hints.
🔔 OneSignal Engagement
We use OneSignal to turn player activity into personalized engagement instead of sending generic notifications to everyone.
Important signals such as progress, streaks, engagement level, player type, and subscription status help determine which notifications are relevant.
👤 PLAYER
│
▼
☁️ PLAYER ACTIVITY
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
📈 Progress 🔥 Streak 🕐 Activity
│ │ │
└─────────────────┼─────────────────┘
▼
🔔 ONESIGNAL
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
📅 Daily Puzzle 🔥 Streak Saver 🎯 Win-Back
│ │ │
└─────────────────┼─────────────────┘
▼
📲 Personalized Push
│
▼
🔗 Deep Link Router
│
┌──────────────┼──────────────┐
▼ ▼ ▼
🧩 Daily 🎯 Level 🏆 Challenge
Puzzle Screen Screen
For example, a Daily Puzzle notification can open directly into that day's puzzle instead of simply opening the home screen.
This creates a tighter loop between player behavior → personalized engagement → returning to gameplay.
🚧 Challenges We Ran Into
Building the game itself was only one part of the challenge.
The harder problem was making gameplay, monetization, subscriptions, advertising, backend state, and notifications behave as one system.
🔄 Keeping Everything in Sync
🎮 GAMEPLAY
│
▼
📊 PLAYER PROGRESS
│
┌───────────────┼───────────────┐
▼ ▼ ▼
☁️ SUPABASE 💎 REVENUECAT 🔔 ONESIGNAL
Player State Pro Entitlement Engagement
│ │ │
└───────────────┼───────────────┘
▼
🔄 CONSISTENT STATE
│
▼
🧩 PLAYER EXPERIENCE
Some of the biggest challenges were:
- 🔄 Pro Entitlement Sync — Keeping Pro access synchronized with gameplay state.
- 💳 Subscription Integration — Connecting Google Play subscriptions to RevenueCat correctly.
- 📅 Multiple Plans — Supporting both monthly and annual subscription products.
- 🎬 Reward Validation — Ensuring rewarded ads grant exactly one hint only after successful completion.
- 🚫 Ad-Free Pro — Preventing ads from appearing for Pro users.
- 📡 Offline Gameplay — Maintaining core gameplay functionality during offline conditions.
- 👤 Account Upgrades — Ensuring Guest → Google account upgrades do not lose player state.
- 🔔 Notification Quality — Avoiding unnecessary notification spam.
- 🏷️ OneSignal Limits — Keeping custom tags within the Free-plan limit.
- 🔗 Deep Linking — Making notifications open the correct destination inside the game.
We specifically reduced OneSignal's custom tags to the essential gameplay attributes to stay within the 10-tag limit.
🏆 Accomplishments That We're Proud Of
🎮 We Built More Than a Puzzle Board
We didn't stop at creating individual puzzles. We built a complete gameplay loop connecting solving, progression, rewards, and retention.
🧩 PUZZLE
│
▼
🧠 SOLVE
│
▼
🎁 REWARD
│
▼
📈 PROGRESS
│
▼
🔥 STREAK
│
▼
📅 DAILY RETURN
│
▼
🏆 MASTERY
│
▼
🔁 REPEAT
💳 Real Subscription Architecture
Monthly and yearly subscriptions are connected through RevenueCat using a common numpath_pro entitlement.
This gives the game a single source of truth for determining whether a player has Pro access.
🎁 Gameplay-Friendly Monetization
Players can voluntarily watch an AdMob rewarded video to earn an additional hint instead of being forced to pay.
This keeps monetization connected to an existing gameplay need.
🔔 Behavioral Engagement
OneSignal doesn't just send notifications.
It uses meaningful game-state attributes to create targeted player segments and relevant engagement campaigns.
🧠 Designed for Retention
The game understands concepts such as:
👤 PLAYER STATE
│
┌────────────┼────────────┐
▼ ▼ ▼
🎯 LEVEL 🔥 STREAK 📊 ENGAGEMENT
│ │ │
└────────────┼────────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
💎 PRO STATUS 📅 DAILY 👤 PLAYER TYPE
PUZZLE
│ │ │
└────────────┼────────────┘
▼
🎯 PERSONALIZED
EXPERIENCE
These signals help create a more personalized experience based on how players actually interact with Numpath.
🔗 End-to-End Integration
Our final architecture connects the entire mobile game ecosystem:
👤 PLAYER
│
▼
┌────────────────┐
│ 🎮 FLUTTER │
│ GAME │
└───────┬────────┘
│
┌─────────────┼─────────────┐
▼ ▼ ▼
☁️ SUPABASE 💎 REVENUECAT 🔔 ONESIGNAL
│ │ │
│ ▼ │
│ 📱 GOOGLE PLAY │
│ + │
│ 📺 ADMOB │
│ │
└─────────────┬─────────────┘
▼
🧩 COMPLETE MOBILE
GAME SYSTEM
🧠 What We Learned
The biggest lesson was that building a game and building a sustainable game are two different problems.
A puzzle can work perfectly on its own, but creating a complete product requires gameplay state, monetization, progress, and engagement to work together.
🔗 Connecting Game State
🎮 GAME STATE
│
┌─────────────┼─────────────┐
▼ ▼ ▼
💰 MONETIZATION 📈 PROGRESS 🔔 ENGAGEMENT
│ │ │
RevenueCat Supabase OneSignal
│
▼
📱 Google Play
│
▼
📺 AdMob
We also learned that monetization works best when it fits the player's motivation.
- 💡 A player who wants another hint can watch a rewarded ad.
- 💎 A dedicated player who wants uninterrupted gameplay can upgrade to Pro.
- 📅 A returning player can receive a daily puzzle reminder.
- 🔄 An at-risk player can receive a gentle win-back message.
The technology becomes valuable when it supports the game design rather than distracting from it.
🚀 What's Next for Numpath Puzzle
Our next goal is to turn Numpath from a polished puzzle game into a long-term competitive puzzle platform.
🌱 From Solo Puzzle Game to Puzzle Platform
🧩 NUMPATH TODAY
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
🎯 CAMPAIGN 📅 DAILY 💎 PRO
LEVELS PUZZLES PLAYERS
│ │ │
└─────────────────┼─────────────────┘
▼
🚀 NEXT EVOLUTION
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
👥 MULTIPLAYER 🏆 EVENTS 📊 LEADERBOARDS
│ │ │
▼ ▼ ▼
⚔️ CHALLENGES 🗓️ SEASONS 🥇 COMPETITION
│ │ │
└─────────────────┼─────────────────┘
▼
🌍 NUMPATH
COMMUNITY
Future versions can expand into:
- 🧩 More Puzzle Modes
- 🌍 Global & Friend Leaderboards
- 👥 Multiplayer Challenges
- 🏆 Seasonal Competitions
- 📅 More Daily Puzzle Formats
- 📊 Advanced Player Statistics
- 🔔 More Sophisticated Engagement Campaigns
- 🧠 Personalized Difficulty
- 🏆 Additional Achievement Systems
- 💎 Expanded Pro Features
Our long-term vision is simple:
🧠 Make Numpath the kind of game that takes only two minutes to play, but keeps your brain coming back every day.
Log in or sign up for Devpost to join the conversation.