Flitwing One-Tap Flying Game App

Overview

Flitwing is a one-tap flying game built on Expo SDK 57 and React Native with the FluxNative kernel. The first screen is the game: a bright morning sky over a meadow, the bird bobbing beside its wordmark, your best and its medal, and a pulsing Tap to fly. Each tap sets the bird's upward speed; posts slide in with a gap to fly through, every post passed is a point and a golden seed is three. A crash freezes for a beat, shakes the world and drops the bird, then one panel shows the score, the best, the medal and the coins, with Play again starting the next round at once.

With .env blank the game runs in sample mode: a player two weeks in with a best of 47 (silver), 1,240 coins, three birds, ten recent runs, missions half done and day 4 of the daily reward waiting. Everything the player does is kept on the device. Setting the Supabase values turns on the weekly board; setting the RevenueCat keys sells Plus.

Key features

• The game: ready, flying, paused and over on one full-bleed screen, with the score top left over the best, the coin pill and a round pause button top right, and a raised dock of drawn icons to Shop, Missions, Scores and Settings

• Rules in a pure engine (engine.ts), unit-tested: a tap sets the upward speed, the first post arrives 2.4 s after the first tap, the gap narrows every 10 posts with three easy posts after each step

• Shop: eight birds that differ by build, face, tail, beak and one prop (a tuft, goggles, a scarf, a leaf cap, a bobble hat, a flame crest, a star trail), each on a twig on a tile in its colour, locked ones as silhouettes behind a padlock, the one on show big on a branch

• Missions: three at a time from real runs (pass 20 posts in one run, take 8 golden seeds, fly for 3 minutes…), a coin reward each, harder each time round the ladder

• Daily reward: a 7-day ladder by the phone's date, drawn as posts rising from the meadow with the bird perched on today's

• Leaderboard: a podium of the week's three best birds on posts, the flock of rival birds to beat, your ten best runs and a chart of the last ten; with Supabase a weekly board of every player

• How to play: three steps drawn with the game's own sprites, and the four medals

• Settings: sound effects, vibration, reduce motion, How to play, Plus, About, Terms of use, Privacy policy and Delete my data

Screens

10 screens: the game (ready, flying, paused, over), Shop, Missions, Leaderboard, How to play, Flitwing Plus, Settings, About, Terms of use and Privacy policy. One stack with no tab bar. Every pushed screen lives in the game's world: its sky is the page and the meadow runs along its foot, titles are drawn in the wordmark's outlined type, and each screen is staged its own way (a bird on a branch in the shop, a podium of posts on the leaderboard, a flock on Plus). Only what you tap is raised: chunky buttons with a lip that sinks, over flat framed boards and wooden plaques. The day look holds in light and dark, as most casual games do.

Game and backend

• One requestAnimationFrame loop while flying, a pure step(game, dt) with dt clamped to 0.05 s, seeded randomness, taps through PanResponder at touch-down (touch, mouse and the preview's taps)

• The game folder reads app data through one hook (useGameProgress), so it lifts into another app

• Weekly board on Supabase: nobody reads the tables (row-level security, a player sees only their own runs); the board comes from one function with names, bests, places and the sample rivals marked, never an id; anonymous sign-in, names made on the server from the player's id

• The server times every run: start_run at the first tap, then submit_score takes each run once and refuses a score the run's time cannot hold or a run longer than the time since it started; the rule is held to the engine by tests

• A run that ends offline is kept and sent later, and the board says when the last run did not go up; eight sample rivals, marked as samples, fill the first week

• Delete my data clears the device and takes the player's runs off the board, waiting for the network when it must; Plus stays with the store account

Monetisation

Flitwing Plus is one non-consumable in-app purchase sold through the App Store and Google Play with RevenueCat (react-native-purchases): every bird, including Midnight that only Plus has, and double coins on every run. Access comes from the plus entitlement only, with Restore purchase on the Plus screen. Without RevenueCat keys the Plus screen shows the intended price marked as a sample, says purchases open in the App Store version, and never grants access. No ads, no loot boxes, nothing that pays out.

Setup

• Connect Supabase, apply the migration and allow anonymous sign-ins for the weekly board

• Connect RevenueCat with a flitwing_plus product and a plus entitlement to sell Plus

• Rename the game, then reskin the sky, the posts and the birds in palette.ts and art.tsx

• Set NEW_DEVICE_SAVE to empty and replace the sample Terms of use and Privacy policy before you ship