epic-you

As a developer, I want to align all color tokens and theme variables across the project so that the visual identity is consistent with the Last Survival brand across all pages. This includes defining primary, secondary, accent, background, and text color tokens in a centralized theme config.

As a player, I want to browse and purchase cosmetic items in the store so that I can personalize my characters with skins and accessories. Implement based on existing v1 JSX design, including featured items, skin catalog, currency display, purchase flow, and navigation back to character equip.

As a player, I want to browse and select characters so that I can choose my preferred role and playstyle before entering a match. Implement based on existing v1 JSX design, covering browse and select states, character role display (Sniper, Rusher, Defender, Support), ability previews, and navigation to skins and equip flows.

As a new player, I want a training page so that I can practice game mechanics in a safe environment before entering live matches. Implement based on existing v1 JSX design, including training mode selection, bot difficulty options, weapon practice zones, and progression to the home lobby after completion.

As a new player, I want to see an engaging splash screen on launch so that I am introduced to the Last Survival brand before proceeding to signup or login. Implement based on existing v1 JSX design, including animated logo, loading indicator, and transition to the signup or home flow.

As a new player, I want to create an account through a signup page so that I can access the game and begin my progression. Implement based on existing v1 JSX design, including username, email, password fields, validation feedback, and navigation to the training or home flow post-registration.

As a competitive player, I want to view my current rank and progression on a ranks page so that I can track my standing in the competitive ladder. Implement based on existing v1 JSX design, including rank tier display (Bronze to Master), rank points, tier thresholds, and leaderboard preview.

As a player, I want a profile page so that I can view my overall game progression, stats, and achievements. Implement based on existing v1 JSX design, including player level, XP bar, match history summary, win rate, total kills, equipped character display, and battle pass progress.

As a player, I want a central home lobby page so that I can navigate to all core game modes and features from a single hub. Implement based on existing v1 JSX design, including mode selection (Classic, Squad, 1v1), quick access to profile, store, characters, and matchmaking entry points.

As a backend developer, I want to implement a store and skins API so that players can browse, purchase, and equip cosmetic items. Covers cosmetic skins catalog with rarity tiers, featured and rotating store inventory, in-game currency management, purchase transaction recording, owned skins inventory per player, and equip/unequip endpoints linked to the character system.

As a backend developer, I want to implement a character abilities API so that the frontend can retrieve character data, roles, and unique ability definitions for each character type. Covers four roles: Sniper (long-range precision), Rusher (speed boost), Defender (shield/barrier), and Support (heal/revive). Includes endpoints for listing characters, fetching ability details, and equipping a character to a player profile.

As a competitive player, I want a matchmaking page so that I can queue for a match in my preferred mode and be matched with players of similar rank. Implement based on existing v1 JSX design, covering queue state, mode selection (Classic, Squad Match, 1v1), rank display, and waiting/cancel states.

As a player, I want to preview character skins so that I can customize the appearance of my selected character before purchasing or equipping. Implement based on existing v1 JSX design, including skin preview carousel, rarity indicators, purchase CTA linking to store, and equip confirmation flow.

As a squad player, I want a squad management page so that I can create a squad, invite friends, and enter a squad match together. Implement based on existing v1 JSX design, including squad creation, friend invite list, squad lobby with member slots, ready state indicators, and squad matchmaking entry.

As a player, I want a match HUD page so that I can view critical in-game information during an active match. Implement based on existing v1 JSX design, including health/armor bars, ammo counter, minimap, zone timer, squad status indicators, kill feed, and revive prompts for squad mode.

As a backend developer, I want to implement a matchmaking API so that players are matched with opponents of similar rank across supported game modes. Covers rank-based skill matching, queue management (join/cancel/status polling), and support for Classic (solo), Squad, and 1v1 modes. Includes session token generation on match found and squad-aware grouping logic.

As a player, I want to view a post-match results page so that I can review my performance stats and track my progression after each game. Implement based on existing v1 JSX design, including placement display, kills/damage/survival time stats, XP earned, rank change indicator, and team stats for squad mode.

As a backend developer, I want to implement a match session API so that the game server can manage the full lifecycle of an active match. Covers session initialization and teardown, loot spawn and pickup tracking, shrinking zone phase scheduling, player elimination events, squad revive system, and final placement recording for results processing.

As a backend developer, I want to implement a squad system API so that players can form squads with friends and enter matches together. Covers squad creation and dissolution, friend invite by username or ID, invite accept/decline handling, squad lobby state synchronization, and integration with the matchmaking API to queue as a group.

As a backend developer, I want to implement a weapons and loot system API so that matches have a fully functional item ecosystem. Covers weapon type definitions (AR, SMG, Sniper, Shotgun, Pistol, Grenades) with stat profiles, ammo type associations, medical item definitions (medkits, bandages, armor vests), loot table configuration with rarity-weighted spawn probabilities, and loot zone spawn point management integrated with the match session lifecycle.

As an AI engineer, I want to implement an AI bot system so that new players can practice against intelligent bots in training mode. Covers bot behavior trees for difficulty levels (Easy, Medium, Hard), role-aware bot actions aligned to character roles (Sniper, Rusher, Defender, Support), bot pathfinding within the shrinking zone, loot collection behavior, and integration with the match session API for training mode spawning.

As a backend developer, I want to implement a results and stats API so that post-match data is persisted and surfaced to players after each game. Covers storing per-match stats (kills, damage, survival time, placement), XP calculation based on performance, rank point delta computation, and team stats aggregation for squad matches.

As a backend developer, I want to implement a progression system API so that players are rewarded for consistent play through leveling, battle pass, and daily missions. Covers XP leveling curve and level-up rewards, battle pass tier unlocks (free and premium tracks), daily and weekly mission definitions and completion tracking, and reward crate drop and opening mechanics.

As a backend developer, I want to implement a rank system API so that players progress through competitive tiers based on match performance. Covers rank tier definitions (Bronze, Silver, Gold, Platinum, Diamond, Master), rank point thresholds, promotion and demotion logic, rank decay rules, and endpoints for fetching current rank and leaderboard positions.