Documentation

ArrowTangle v1.0.0

A Flutter arrow-sliding puzzle game for Android and iOS. Download the code, connect Firebase, AdMob and in-app purchases, and publish.

Players tap an arrow to slide it off a 3D board and must find the order that clears every arrow. Included: 1,300 ready-made levels in 26 worlds, a daily puzzle with streaks, quests, 27 achievements, arrow skins, a coin economy, rewarded and interstitial ads, in-app purchases, a Firebase leaderboard with Google or guest sign-in, and 15 language slots.

No own server and nothing to generate. The levels are already built into the app, and Firebase (sign-in, coins, leaderboard, cloud save) can start on its free Spark plan. You can play the game before you configure anything; coins are only kept for the current session until Firebase is connected.

Setup at a glance

Do these in order. Each step is a short section of this page.

#StepWhat you do
1Name, icon, package idReplace the com.vertexstation.arrowtangle id with your own, plus the icon and name
2FirebaseCreate a project, run one command, switch on sign-in and Firestore, publish the rules
3AdMobAdd your app id and two ad unit ids per platform
4In-app purchasesCreate 4 products in Play Console / App Store Connect
5Build & publishAdd legal links, sign the app, build and upload
6Costs & responsibilitiesRead which services may charge you and what you are responsible for

Install & Run

ToolVersion
Flutter SDK (stable)3.47+ (Dart ^3.13.5)
Java17 (Android builds)
Xcode15+ on macOS, iOS target 15.0 (iOS builds)
1

Open the project folder in Android Studio or VS Code and run flutter doctor to check your setup.

2

Get the packages and start the game on a device or emulator:

Terminal
flutter pub get
flutter run
3

Optional: check everything is healthy:

Terminal
flutter analyze
flutter test

The first run uses Google's sample ad units (debug builds only) and placeholder Firebase values, so the game starts with nothing configured. You replace both before publishing (steps 2 and 3). The package contains no machine-specific files: android/local.properties, .gradle and other build folders are created by Flutter on your computer the first time you run the app.

Project Structure

PathWhat is inside
lib/config/app_config.dartAll keys, ad frequency, prices and legal links in one file
lib/core/Theme and colors, texts and languages, coin economy, arrow skins
lib/domain/Game rules, solver, hints, level generator and daily puzzle (pure Dart)
lib/data/, lib/services/Saved data; ads, purchases, sign-in, leaderboard, reminders
lib/features/One folder per screen
assets/levels/, assets/sfx/The 1,300 levels and 15 sound effects

State is handled with flutter_bloc, navigation with go_router, saves with shared_preferences. Every service (ads, store, sign-in, leaderboard) has an offline stand-in, which is why the game runs with no accounts.

1. Name, Icon & Package ID

App name

The name is ArrowTangle. To change it, edit these:

  • android/app/src/main/AndroidManifest.xml: android:label
  • ios/Runner/Info.plist: CFBundleDisplayName and CFBundleName
  • lib/core/localization/translations.dart: app_title, rate_app, share_msg, then search the project for any other ArrowTangle text

Do not rename the string arrow-quest-daily in lib/domain/daily/daily_puzzle.dart. It seeds the daily puzzle, and changing it changes every daily board.

Package ID

The project ships with the identifier com.vertexstation.arrowtangle on Android and iOS. Store ids are unique, so you must publish under your own id, for example com.yourcompany.yourgame (lower case letters, digits, underscores and dots). Use the same id everywhere:

1

Android id: in android/app/build.gradle.kts change both namespace and applicationId.

2

Android activity: move android/app/src/main/kotlin/com/vertexstation/arrowtangle/MainActivity.kt to the folder that matches your id (for com.yourcompany.yourgame: kotlin/com/yourcompany/yourgame/) and change its first line to package com.yourcompany.yourgame. Delete the old empty folders.

3

iOS bundle id: open ios/Runner.xcworkspace in Xcode, select Runner > Signing & Capabilities and set the Bundle Identifier (do it for Debug, Release and Profile). Alternatively replace every com.vertexstation.arrowtangle in ios/Runner.xcodeproj/project.pbxproj (PRODUCT_BUNDLE_IDENTIFIER).

4

App config: in lib/config/app_config.dart update the defaults of playPackageName and storeUrl (or pass PLAY_PACKAGE_NAME and STORE_URL when building).

5

Firebase: run flutterfire configure (step 2) after changing the id, so google-services.json and lib/firebase_options.dart are generated for the new id.

Tip: search the whole project for com.vertexstation.arrowtangle; after these steps the only results should be gone or replaced by your id.

Android SDK levels

The SDK levels are declared explicitly in android/app/build.gradle.kts, so builds do not depend on your local Flutter version: compileSdk = 36, targetSdk = 36 and minSdk = 24 (Android 7.0). Raise them there when Google Play requires a newer target level.

Icon & splash

Replace the images in assets/icon/ keeping the same file names (icon.png 1024 x 1024 without transparency, icon_foreground.png, splash.png), then run:

Terminal
dart run flutter_launcher_icons
dart run flutter_native_splash:create

2. Firebase

Firebase provides guest and Google sign-in, the coin balance, the leaderboard, cloud save and crash reports. It needs no Cloud Functions or own server and can start on the free Spark plan; a growing game may exceed the free quotas and then needs the paid Blaze plan with an active billing account (see Costs & Responsibilities).

Where coins are stored

Coins are not stored on the device. Each player's balance lives in Cloud Firestore at wallets/{uid} (fields coins, lifetime, updatedAt), for guests and Google accounts alike, so it follows the account to a new phone. Firestore's built-in offline cache keeps the balance usable without a connection and syncs changes when the device is back online. Every change is an atomic increment, so two devices on the same account never overwrite each other. The code is in lib/services/coin_bank.dart.

The package ships with placeholder Firebase values in lib/firebase_options.dart, android/app/google-services.json and .firebaserc. Until you finish this step the game treats Firebase as not configured and runs offline.

1

Create a project at console.firebase.google.com, then install the tools:

Terminal
npm install -g firebase-tools
dart pub global activate flutterfire_cli
firebase login
2

Link the app. Pick your project and the Android and iOS platforms; it reads the package id you set in step 1 and rewrites lib/firebase_options.dart, google-services.json and the iOS config:

Terminal
flutterfire configure
3

In the console: Authentication > Sign-in method: enable Anonymous and Google. Firestore Database: create a database.

4

Open .firebaserc and put your project id in "default", then publish the security rules:

Terminal
firebase deploy --only firestore:rules
5

Copy the Web client id (Authentication > Sign-in method > Google) into googleWebClientId in lib/config/app_config.dart, or pass it as GOOGLE_WEB_CLIENT_ID when building.

6

Android: add your SHA-1 and SHA-256 fingerprints (debug and release; also Play App Signing, once you upload) under Project settings > Your apps, then run flutterfire configure again. Google sign-in fails without them.

7

iOS: confirm GoogleService-Info.plist is in the Runner target, and add its REVERSED_CLIENT_ID as a URL scheme in ios/Runner/Info.plist.

8

Optional: in the console enable Crashlytics and set a budget alert.

What the rules protect: a leaderboard score is accepted only from the signed-in player with valid stars (1-3), time and name, and the score formula must match; a coin balance can be read and changed only by its owner, can never go below zero, and a single write can add at most 5,000 coins; cloud saves are private to their owner; invite rewards are capped. They are in firestore.rules. For full server-side validation of rewards you can add Cloud Functions (requires the Blaze plan).

If Firebase is not configured the game does not crash. It logs "Firebase not configured", the Ranking screen shows only the player's own results with an Offline banner, and coins are kept only until the app is closed. Connect Firebase before publishing.

3. AdMob

The game shows rewarded video (hints, double coins, free coins) and interstitials between levels. The project contains Google's public sample ad units only so that debug builds show test ads. Release builds refuse the sample units and show no ads until you pass your own ad unit ids, so sample ads can never reach players.

1

Create the app in AdMob for each platform and copy the app id (looks like ca-app-pub-123~456).

2

Android: replace the value of com.google.android.gms.ads.APPLICATION_ID in android/app/src/main/AndroidManifest.xml.

3

iOS: replace the value of GADApplicationIdentifier in ios/Runner/Info.plist (it currently holds Google's test id):

Info.plist
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-123~456</string>
4

Create one rewarded and one interstitial ad unit per platform and pass them when building (see the list of values in Build & Publish).

5

Optional: tune how often ads show in lib/config/app_config.dart:

app_config.dart
static const interstitialEvery = 4;         // every 4th cleared level
static const interstitialFromCleared = 8;   // never before 8 cleared levels
static const maxRewardedPerDay = 10;        // daily cap
6

For players in the EU and UK, add Google's consent message (UMP) before release.

Players who buy Remove Ads or Premium never see interstitials. Rewarded videos are always optional.

Never tap your own live ads. Keep the test ids while developing, or AdMob may suspend your account.

4. In-App Purchases

Create these four products with exactly these ids in Play Console (Monetize > In-app products) and App Store Connect, and make them active.

Product idTypeGives the player
remove_adsNon-consumableNo interstitial ads
premium_passNon-consumableNo ads, 2x coins, 10 hints, Royal Gold and Neon skins
coins_500Consumable500 coins
coins_1500Consumable1,500 coins
1

Upload a build to an internal testing track and install it from Google Play. Purchases do not work in a normal debug install.

2

Add your Gmail address as a license tester to buy for free while testing.

3

Recommended: pass your Play licensing key (Play Console > Monetization setup) as PLAY_LICENSE_KEY so the app verifies every receipt signature.

Different ids or coin amounts? Edit the product* and coinPacks constants in lib/config/app_config.dart. "Restore purchases" is already in Settings, as the stores require.

5. Build & Publish

Legal links

Host a privacy policy and pass its address as PRIVACY_URL. It must mention AdMob (ads), Firebase (sign-in, leaderboard, crash reports) and Google Play / App Store purchases. Stores also require an account-deletion URL; the in-app flow already exists (Settings > Account > Delete account). In the Play data-safety form declare: device or account ids, purchase history, crash logs and ad data.

Sign the Android app

1

Create an upload key:

Terminal
keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
2

Copy android/key.properties.example to android/key.properties and fill in the passwords. The build picks it up automatically. Never share this file.

Build

Terminal
flutter build appbundle --release \
  --dart-define=PRIVACY_URL=https://your-site.com/privacy \
  --dart-define=SUPPORT_EMAIL=you@example.com \
  --dart-define=ADMOB_REWARDED_ANDROID=ca-app-pub-xxx/111 \
  --dart-define=ADMOB_INTERSTITIAL_ANDROID=ca-app-pub-xxx/222 \
  --dart-define=GOOGLE_WEB_CLIENT_ID=xxx.apps.googleusercontent.com \
  --dart-define=PLAY_PACKAGE_NAME=com.yourcompany.arrowtangle \
  --dart-define=PLAY_LICENSE_KEY=your_base64_key

Output: build/app/outputs/bundle/release/app-release.aab. For iOS run flutter build ipa --release with the iOS values (ADMOB_REWARDED_IOS, ADMOB_INTERSTITIAL_IOS).

OptionRequired?Purpose
ADMOB_REWARDED_ANDROID / _IOSYesYour rewarded ad unit
ADMOB_INTERSTITIAL_ANDROID / _IOSYesYour interstitial ad unit
PRIVACY_URL, TERMS_URLPrivacy: yesLinks shown in Profile and the welcome screen
SUPPORT_EMAILRecommendedSupport contact
GOOGLE_WEB_CLIENT_IDIf not edited in the fileGoogle sign-in
PLAY_PACKAGE_NAMEYesMust equal your applicationId
PLAY_LICENSE_KEYRecommendedVerifies purchase receipts
STORE_URLRecommendedStore link added to share and invite messages

Before you upload

  • Sample Firebase project replaced with yours, rules published (they include the wallets coin rules)
  • Billing accounts and budget alerts set up where needed (see Costs & Responsibilities)
  • Real AdMob app id (Android and iOS) and ad units in place
  • Four in-app products created and active; tested with a license tester
  • Package id changed everywhere; icon and name replaced
  • Played 20 levels on a real phone, plus: guest start, Google sign-in, restore on a second device, a rewarded ad, a purchase and restore, airplane mode
  • Release on an internal testing track first, then closed, then production

Official guides: Android, iOS.

Costs & Responsibilities

The source code is a one-time purchase, but the third-party services it connects to are operated by Google and Apple under their own terms and prices.

Using Firebase and AdMob in production may incur costs or require active billing accounts. Firebase offers a free Spark plan with usage limits; beyond them (or to use Cloud Functions) you need the pay-as-you-go Blaze plan with a billing account. AdMob requires a verified AdMob account with payment and tax details to receive earnings.

ServiceWhat may cost money
Firebase (Auth, Firestore, Crashlytics)Firestore reads, writes and storage above the free quota; Blaze plan billing
Google AdMobAccount and payment setup; AdMob and Google policies decide what you earn and may deduct fees
Google Play Billing / Apple In-App PurchaseStore service fees on every purchase (commission taken by Google or Apple), taxes
Google Play Console / Apple Developer ProgramDeveloper account registration fees

You, the buyer, are responsible for all service fees and costs related to Firebase, AdMob, in-app purchase processing (Google Play and App Store commissions), developer accounts and taxes, and for complying with each service's terms and policies. These are not included in the price of this item. We recommend setting a budget alert in the Google Cloud console.

Colors, Texts & Languages

Colors and fonts

Every color is a token in lib/core/theme/tokens.dart, with a dark and a light palette. Change a value once and the whole app follows. Fonts are Outfit and Inter in assets/fonts/.

bg
#0E1424
surface
#172036
mint (accent)
#22C7A9
gold (buttons)
#F5B94C
coral (errors)
#FF6B6B
ink (text)
#F3F6FA

Texts and languages

All texts are in lib/core/localization/translations.dart (one block per language code, used as context.tr('key')). Missing keys fall back to English. The language list is in lib/core/localization/app_localizations.dart.

Complete texts exist for English, Bengali and Hindi. The other 12 listed languages (Urdu, Turkish, Arabic, Spanish, Portuguese, French, German, Italian, Japanese, Korean, Chinese, Russian) are registered but show English until you add a block for them. To add one, copy the en block, change the code, and translate.

Levels, Economy & Skins

Levels

26 worlds of 50 levels (1,300) are included and verified solvable. You do not need to generate anything. Each world is a plain JSON file in assets/levels/, so you can inspect or replace levels directly. Do any level edits before release, because changing level ids would reset players' progress.

Economy

RewardValue
Level clear10 coins + 5 per star + 5 for a perfect run; +25 every 5th perfect clear
Daily puzzle40 + 10 per star
7-day login reward20, 30, 40, 50, 75, 100, 150 coins; day 7 also gives 3 hints
PremiumDoubles every coin reward
Hint / streak shield40 / 150 coins

Rewards are in lib/core/economy/economy.dart; prices and limits in lib/config/app_config.dart. Stars: 3 for no mistakes and no hints, 2 for at most 2 mistakes and 1 hint, otherwise 1.

Arrow skins and sound

Seven skins (Classic, Coral, Ocean, Sakura, Lime, and Premium-only Royal Gold and Neon) are listed in lib/core/economy/skins.dart; add one and it appears in the shop. Sound effects are WAV files in assets/sfx/; replace any file with your own using the same name.

Features & Screens

FeatureDetails
GameplayTap an arrow to slide it out if its path is clear; a blocked arrow is a mistake. Undo, restart, hints and an optional path preview. Stones and shaped boards in later worlds.
Progression26 worlds, 1,300 levels, 3-star ratings, worlds unlock as you go
DailyA new puzzle every day with calendar, streaks, streak shield, 3 daily quests and a 7-day login reward
Achievements27 achievements with coin rewards
RankingDaily, weekly and best leaderboards through Firebase
ShopPremium, Remove Ads, coin packs, free-coin video, streak shield and skins
AccountsGuest or Google sign-in, cloud backup, delete account
SettingsTheme, reduced motion, language, sound, haptics, daily reminder, path preview
Home
Home
Gameplay
Gameplay
Worlds
Worlds
Level select
Level select
Daily puzzle
Daily puzzle
Quests
Quests
Ranking
Ranking
Achievements
Achievements
Shop
Shop
Stats
Stats
Settings
Settings
Profile
Profile

Troubleshooting

ProblemFix
Ranking says "Offline"Firebase is not configured, Anonymous sign-in is off, the rules are not published, or there is no network.
Google sign-in fails in release onlyAdd the release (and Play App Signing) SHA-1 and SHA-256 to Firebase, then run flutterfire configure again.
iOS app closes on startThe AdMob app id in Info.plist is malformed, or GoogleService-Info.plist is in the wrong place after flutterfire configure.
Purchases say "item not found"Install from a Play testing track; the product ids must match exactly and be active.
Ads do not loadCheck the ad unit ids and wait some minutes after creating them. Use test ids while developing.
Build fails after changing the package idRun flutterfire configure again, then flutter clean and flutter pub get.
Achievement names show as ach_..._titleA translation key is missing from translations.dart; add every ach_<id>_title key to each language block you ship.

Support

Need help? Reach out to our support team.

Support Email: vertexstation@gmail.com

Please include your item purchase code, a clear description of the problem and any error output.