System Requirements Document (SRD)

Project Name: Lunar-Candy

1. Introduction

Welcome to the System Requirements Document (SRD) for Lunar-Candy, a mobile-based Candy Crush-style game envisioned by Dinahari Kashyap from India. This document outlines the requirements, design concepts, and technical specifications for the project. Lunar-Candy aims to deliver a fun, addictive, and visually stunning gaming experience tailored for mobile users.

The game will feature match-three mechanics, vibrant visuals, and engaging gameplay elements, with potential additions like leaderboards, daily rewards, and multiplayer challenges.

2. System Overview

Lunar-Candy is a mobile game designed to entertain users with a match-three puzzle format. Players will match candies of various colors and shapes to clear levels, earn points, and unlock rewards. The game will include:

• A progression system with increasingly challenging levels.
• Power-ups and boosters to enhance gameplay.
• A visually appealing candy-themed design.
• Optional social features like leaderboards and multiplayer modes.

The game will be optimized for Android and iOS platforms, ensuring smooth performance and intuitive controls for mobile users.

3. Functional Requirements

Story Points:

• As a Player, I should be able to match three or more candies to score points.
• As a Player, I should be able to progress through levels with increasing difficulty.
• As a Player, I should be able to earn power-ups and boosters to help clear levels.
• As a Player, I should be able to view my score and level progress.
• As a Player, I should be able to compete on leaderboards with other players.
• As a Player, I should be able to receive daily rewards for logging in.
• As a Player, I should be able to invite friends to play and compete in multiplayer challenges.

4. User Personas

1. Player

• Description: The primary user of Lunar-Candy. Players are casual gamers who enjoy puzzle games and seek entertainment on their mobile devices.
• Goals: Progress through levels, earn rewards, and compete with friends.
• Pain Points: Frustration with overly difficult levels or lack of engaging features.

2. Admin

• Description: The backend manager responsible for maintaining the game, monitoring leaderboards, and ensuring smooth operations.
• Goals: Manage user data, monitor game performance, and address technical issues.
• Pain Points: Ensuring server stability and handling large-scale user interactions.

5. Visuals Colors and Theme

Color Palette:

To reflect the candy theme and create an engaging visual experience, the following unique color palette is proposed:

• Background: #FFFAF3 (Creamy White)
• Surface: #FFD1DC (Soft Pink)
• Text: #3D3D3D (Charcoal Gray)
• Accent: #FF6F61 (Candy Red)
• Muted Tones: #B2E3E3 (Mint Green)

The palette combines playful candy-like colors with a clean and modern aesthetic to ensure visual appeal and readability.

6. Signature Design Concept

Interactive Candy Galaxy Homepage

The Lunar-Candy homepage will feature a 3D interactive candy galaxy. Upon opening the app, players will see a floating galaxy filled with colorful candies orbiting around a central "Candy Planet." Each candy represents a game feature or section (e.g., Levels, Leaderboards, Daily Rewards).

Key Features:

• Animations: Candies will gently orbit and sparkle, creating a mesmerizing effect.
• Interactions: Players can tap on candies to zoom into specific sections. For example, tapping a candy labeled "Leaderboards" will open the leaderboard screen.
• Transitions: Smooth transitions with candy-themed animations (e.g., candies bursting into smaller pieces when tapped).
• Color Shifts: The galaxy background will subtly change colors based on the time of day (e.g., pastel tones in the morning, vibrant hues in the evening).

This design concept ensures Lunar-Candy makes a memorable first impression and immerses players in the candy-themed universe.

7. Non-Functional Requirements

• The game must load within 3 seconds on standard mobile devices.
• The app must support Android (version 8.0 and above) and iOS (version 12 and above).
• The game must handle up to 100,000 concurrent players without performance degradation.
• The app must comply with GDPR and other relevant data protection regulations.
• The game must be optimized for battery efficiency, consuming minimal power during gameplay.

8. Tech Stack

Frontend:

• React Native for mobile app development.

Backend:

• Python with FastAPI for server-side logic.

Database:

• MySQL for relational data (e.g., user profiles, scores).
• MongoDB for storing game state and leaderboards.

AI Models:

• GPT 5.4 for user-friendly responses in chat or help sections.
• Google Nano Banana for generating candy-themed images and assets.

AI Tools:

• Langchain for AI integration.
• Litellm for LLM routing.

Orchestration:

• Docker and docker-compose for local development.
• Kubernetes for server-side orchestration.

9. Assumptions and Constraints

Assumptions:

• Players will primarily use mobile devices with stable internet connections.
• The game will be free-to-play with optional in-app purchases.
• The target audience includes casual gamers aged 12–40.

Constraints:

• Limited budget for initial development and marketing.
• Compliance with app store guidelines for Android and iOS.
• Ensuring compatibility across various screen sizes and resolutions.

10. Glossary

• Match-Three Mechanics: A gameplay style where players align three or more items of the same type to clear them.
• Power-Ups: Special items that provide advantages during gameplay, such as clearing multiple candies at once.
• Leaderboards: A ranking system that displays players' scores and achievements.
• Multiplayer Challenges: Game modes where players compete against each other in real-time.
• Candy Galaxy: The interactive 3D homepage concept for Lunar-Candy.

This concludes the updated System Requirements Document for Lunar-Candy.