System Requirements Document (SRD)

Project Name: starry-android

1. Introduction

The starry-android project aims to convert the existing r4-reels.netlify.app website into a fully functional Android application. This app will combine the website's web view functionality with native features such as notifications and offline support, providing users with a seamless and enhanced mobile experience.

This document outlines the system requirements for the project, ensuring clarity and alignment with the goals set forth by Subham Rao.

2. System Overview

The starry-android application will serve as a hybrid mobile app that integrates the core functionality of the r4-reels.netlify.app website with additional native features.

Key Features:

• Web View: Display the website within the app for consistent functionality.
• Native Notifications: Notify users about new reels, messages, and promotions.
• Offline Support: Allow users to browse cached content and interact with limited features offline.

Target Audience:

The app is designed for users who enjoy consuming and interacting with reels content on mobile devices.

3. Functional Requirements

User Stories:

• As a User, I should be able to view the website content seamlessly within the app via a web view.
• As a User, I should receive notifications for new reels, messages, and promotions.
• As a User, I should be able to browse cached content offline.
• As a User, I should be able to interact with limited features offline, such as liking or saving reels.
• As an Admin, I should be able to manage notification settings and content caching preferences.

4. User Personas

1. User

• Description: Regular app users who consume reels content.
• Goals: Seamless browsing, notifications for updates, offline access.

2. Admin

• Description: Administrators managing app settings and content.
• Goals: Control notifications and offline caching settings.

5. Visuals Colors and Theme

Color Palette:

Based on the provided logo, the app will use a vibrant and modern color scheme:

• Background: #F9F9F9 (soft white)
• Surface: #FFFFFF (pure white)
• Text: #1F1F1F (dark gray)
• Accent: #6A1B9A (deep purple)
• Muted Tones: #BDBDBD (light gray)

This palette ensures a clean and professional look while maintaining the branding of the logo.

6. Signature Design Concept

Concept: Interactive Galaxy of Reels

The app's home page will feature a dynamic, interactive galaxy map where each "star" represents a reel. Users can zoom in and out, swipe between stars, and tap on a star to view the reel.

Details:

• Animations: Stars twinkle subtly, and constellations form as users swipe.
• Transitions: Smooth zooming and panning effects.
• Color Shifts: The galaxy background changes hues based on the time of day (e.g., purple at night, light blue during the day).
• Micro-Interactions: Tapping a star triggers a ripple effect before opening the reel.

This design ensures the app is visually captivating and memorable, creating an unforgettable first impression.

7. Non-Functional Requirements

• Performance: The app must load content within 2 seconds.
• Scalability: Support up to 1 million users concurrently.
• Security: Ensure secure user data storage and encrypted communication.
• Compatibility: Android versions 8.0 and above.

8. Tech Stack

Frontend:

• React Native for mobile app development.

Backend:

• Python with FastAPI for API integration.

Database:

• MySQL for structured data storage.
• MongoDB for unstructured data.

AI Models:

• GPT 5.4 for user-friendly responses.

AI Tools:

• LangChain for AI workflow management.

Orchestration:

• Docker for local development.
• Kubernetes for server-side orchestration.

9. Assumptions and Constraints

Assumptions:

• Users have stable internet connections for initial content loading.
• Notifications will be sent via Firebase Cloud Messaging.

Constraints:

• Offline support is limited to cached content only.
• The app must adhere to Google Play Store guidelines.

10. Glossary

• Web View: A component that displays web content within a mobile app.
• Native Features: Functionalities built specifically for mobile devices, such as notifications and offline support.
• Caching: Storing data locally for offline access.
• Firebase Cloud Messaging: A service for sending notifications to mobile devices.