System Requirements Document (SRD) for calm-app

1. Introduction

The calm-app is a personalized study and productivity application designed specifically for Tanishq Bisen in India. The app aims to help Tanishq manage his study schedule, track progress, and optimize learning using AI-driven features. By integrating tools like a time-table manager, YouTube video summarization, flashcard-based revision, and quizzes, the calm-app will serve as an all-in-one solution for effective learning and time management.

2. System Overview

The calm-app is a mobile application that combines productivity and learning tools to enhance study efficiency. The app will leverage AI to analyze study patterns, suggest optimized schedules, and provide intelligent reminders. It will also include features like YouTube video summarization into notes and mind maps, a flashcard system for revision, and a quiz module for self-assessment. The app will be designed to cater to Tanishq's personal study needs, with a focus on simplicity, usability, and adaptability.

The system will be developed for mobile platforms using React Native for cross-platform compatibility. The backend will be powered by Python and FastAPI, with MySQL as the primary database for structured data storage. AI functionalities will be supported by GPT 5.4 for user-friendly responses and Google Nano Banana for generating visual content like mind maps.

3. Functional Requirements as Story Points

• As a User, I should be able to track my study progress across subjects.
• As a User, I should be able to manage my daily time-table effectively.
• As a User, I should be able to receive AI-driven schedule suggestions based on my study habits and priorities.
• As a User, I should be able to receive reminders and notifications for tasks and updates.
• As a User, I should be able to summarize YouTube videos into notes and mind maps.
• As a User, I should be able to use a flashcard system for efficient revision.
• As a User, I should be able to take quizzes to test my understanding of concepts.

4. User Personas

Primary User

• Name: Tanishq Bisen
• Age: 20s
• Location: India
• Goals: To improve study efficiency, manage time effectively, and prepare for exams with the help of AI-driven tools.
• Pain Points:
  • Difficulty in managing study schedules.
  • Lack of tools to summarize and retain information from online resources.
  • Need for effective revision and self-assessment tools.

5. Visuals Colors and Theme

The calm-app will feature a soothing and modern design, reflecting its purpose of promoting focus and productivity. The color palette will be unique and tailored to create a calming yet engaging user experience.

Color Palette

• primary: #4A90E2 (Serene Blue)
• primary_light: #A3CFF9 (Soft Sky Blue)
• secondary: #F5A623 (Warm Amber)
• accent: #E94E77 (Vibrant Pink)
• highlight: #FFCC00 (Golden Yellow)
• bg: #F9F9F9 (Light Gray)
• surface: rgba(255, 255, 255, 0.9) (Translucent White)
• text: #333333 (Dark Charcoal)
• text_muted: #7F8C8D (Muted Gray)
• border: rgba(0, 0, 0, 0.1) (Subtle Black)

6. Signature Design Concept

Interactive Study Universe

The calm-app will feature an immersive and interactive "Study Universe" as its landing page. Upon opening the app, Tanishq will be greeted with a 3D galaxy-like interface, where each "star" represents a subject or task.

• Interaction:

  • Tanishq can rotate the galaxy using touch gestures, zoom into specific stars, and tap on them to open detailed views of tasks, progress, or study materials.
  • Hovering over a star will display a brief summary of the task or subject.
  • Completed tasks will shine brighter, while pending tasks will appear dimmer, providing a visual representation of progress.

• Animations:

  • Stars will gently pulse, and connections between related tasks will glow when hovered over.
  • The background will feature a subtle, animated gradient that shifts based on the time of day (e.g., warm tones in the morning, cool tones at night).

• Technology:

  • The 3D galaxy will be built using @react-three/fiber and @react-three/drei.
  • Animations and transitions will be powered by gsap for smooth and dynamic effects.

This unique design will make the app visually captivating and encourage Tanishq to engage with his study schedule regularly.

7. Interaction Model & Motion Direction

Interaction Model

• Landing Page: Parallax with interactive 3D elements (Study Universe).
• Internal Pages: Animated with smooth transitions and hover effects for a polished user experience.

Motion Direction

• Landing Page: Layered depth via scroll, with stars and connections moving at different speeds to create a sense of immersion.
• Internal Pages: Moderate scroll-triggered reveals and hover transitions for buttons, cards, and interactive elements.
• Micro-interactions: Subtle animations for task completion, reminders, and notifications to enhance user engagement.

8. Non-Functional Requirements

• Performance: The app should load within 2 seconds on a standard 4G connection.
• Scalability: The system should handle up to 10,000 tasks and schedules without performance degradation.
• Security: User data must be encrypted both in transit and at rest.
• Localization: The app will default to Indian Standard Time (IST) and support English as the primary language.
• Accessibility: The app must comply with WCAG 2.1 AA standards for accessibility.

9. Tech Stack

Frontend

• React Native for mobile app development.

Backend

• Python with FastAPI for API development.

Database

• MySQL for structured data storage.
• MongoDB for unstructured data (e.g., YouTube video summaries).

AI Models

• GPT 5.4 for user-friendly responses.
• Google Nano Banana for generating notes and mind maps.

AI Tools

• Litellm for LLM routing.
• Langchain for AI workflow orchestration.

Orchestration

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

10. Assumptions and Constraints

• The app will be used exclusively by Tanishq, so scalability for multiple users is not a priority.
• The AI models will require an active internet connection to function.
• The YouTube summarization feature assumes access to public video content.
• Notifications will rely on the device's native notification system.

11. Glossary

• AI Scheduling: The use of artificial intelligence to analyze study patterns and suggest optimized schedules.
• Flashcard System: A digital tool for creating and reviewing flashcards to aid in revision.
• Mind Map: A visual representation of information, often used for summarizing and organizing ideas.
• Parallax: A design technique where background and foreground elements move at different speeds to create a sense of depth.
• React Native: A framework for building cross-platform mobile applications using JavaScript.
• FastAPI: A modern web framework for building APIs with Python.
• MySQL: A relational database management system.
• GPT 5.4: A language model for generating human-like text responses.
• Google Nano Banana: An AI model for generating visual content like mind maps.