starry-game

As a player, I want to see an interactive Start Screen with a floating bubble cluster, daily reward claim button, Play button, and social share option so that I can begin my game session. Implement based on the existing Start Screen (v2) JSX design. The screen links to Level Map and triggers daily reward flow. Include dynamic bubble animations, color-shifting background gradient, and micro-interactions on menu options.

As a player, I want to view and select levels from a Level Map so that I can choose which level to play. Implement based on the existing Level Map (v2) JSX design. The map shows at least 50 levels with increasing difficulty indicators, locked/unlocked states, and navigates to the Gameplay screen on selection. Also links to the Shop.

As a player, I want to access an in-game Shop so that I can browse and purchase power-ups (Bomb Bubble, Rainbow Bubble, Fireball) and cosmetic bubble skins using coins or INR in-app purchases. Implement based on the existing Shop (v2) JSX design. Linked from Level Map and Level Complete screen.

As an admin, I want to log into the admin panel so that I can access analytics, revenue, ad configuration, level management, and shop management. Implement based on the existing Admin Login (v2) JSX design. Links to the Dashboard on successful authentication.

As a player, I want backend APIs to manage my coin balance and shop transactions so that I can earn coins, spend them on power-ups or skins, and have purchases reflected in my profile. Build FastAPI endpoints for coin management and item purchases with MySQL persistence.

As an admin, I want backend APIs that expose player analytics and revenue metrics so that I can monitor performance on the Admin Dashboard. Build FastAPI endpoints aggregating player data and ad revenue from MySQL.

As a developer, I want to integrate Google Nano Banana AI to generate in-game bubble designs and visual assets so that the game has unique, high-quality artwork without manual creation. Set up the AI pipeline to produce bubble sprites and UI elements on demand.

As a player, I want a fully interactive Gameplay screen where I can drag to aim and release to shoot bubbles, see a dotted aiming line, match 3+ bubbles to pop them, watch bubbles fall when disconnected, use power-ups, earn points and combos, and access pause/game-over states. Implement based on the existing Gameplay (v2) JSX design. Includes touch controls, smooth animations, sound toggle, and interstitial ad triggers between levels.

As an admin, I want to view an Analytics Dashboard so that I can monitor player metrics and revenue performance at a glance. Implement based on the existing Dashboard (v2) JSX design. Links to Ads Manager, Level Manager, and Shop Manager.

As a player, I want to see a Game Over screen after losing so that I can choose to watch a rewarded ad to continue or return to the Level Map. Implement based on the existing Game Over (v2) JSX design. Includes score display, rewarded ad button, and navigation back to gameplay or level map.

As a player, I want to see a Level Complete screen after clearing a level so that I can collect earned coins, view my score, and navigate back to the Level Map or next level. Implement based on the existing Level Complete (v2) JSX design. Includes coin collection animation, score summary, and share score option.

As an admin, I want to configure and manage interstitial and rewarded ads from an Ads Manager page so that I can control monetization settings. Implement based on the existing Ads Manager (v2) JSX design. Accessed from the Admin Dashboard.

As an admin, I want to edit and publish level configurations from a Level Manager page so that I can update level difficulty, bubble patterns, and push updates to players. Implement based on the existing Level Manager (v2) JSX design. Accessed from the Admin Dashboard.

As an admin, I want to manage shop items (power-ups, skins, pricing) from a Shop Manager page so that I can update the in-game store inventory and pricing. Implement based on the existing Shop Manager (v2) JSX design. Accessed from the Admin Dashboard.

As a player, I want the game frontend to communicate with the backend APIs for player progress, daily rewards, coins, shop, and level data so that all game data is persisted and synced. Wire up API calls from Unity/frontend to FastAPI endpoints, handle auth tokens, error states, and offline fallback.