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.

Setup at a glance

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

Install & Run

flutter pub get
flutter run

flutter analyze
flutter test

Project Structure

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

Package ID

Replace com.example with your own domain; Google Play rejects com.example ids. Change it in all three places, and use the same id everywhere:

• Android: applicationId in android/app/build.gradle.kts
• iOS: bundle identifier in Xcode (open ios/Runner.xcworkspace, Runner > Signing & Capabilities)
• Purchase checks: PLAY_PACKAGE_NAME (see Build & Publish)

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:

dart run flutter_launcher_icons
dart run flutter_native_splash:create

2. Firebase

Firebase provides the leaderboard, guest and Google sign-in, cloud save and crash reports. It runs on the free Spark plan and needs no Cloud Functions or server.

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

flutterfire configure

firebase deploy --only firestore:rules

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; cloud saves are private to their owner; invite rewards are capped. They are in firestore.rules.

3. AdMob

The game shows rewarded video (hints, double coins, free coins) and interstitials between levels. It ships with Google test ad units, which are safe while developing and must be replaced before release.

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-123~456</string>

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

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.

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

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

Build

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).

Before you upload

• Sample Firebase project replaced with yours, rules published
• 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.

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/.

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.

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

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

Troubleshooting

Support

Need help? Reach out to our support team.