System Requirements Document (SRD) for Velvet-App

1. Introduction

The Velvet-App is a personalized birthday card generation application designed to create unique and memorable cards. By leveraging AI technology, the app generates custom birthday cards that include the recipient's name and an AI-generated image based on their hobbies. This app is tailored for users in India (IN) and will provide a seamless, user-friendly experience for creating and sharing personalized birthday cards.

2. System Overview

The Velvet-App is a mobile and web-based application that allows users to:

• Input the recipient's name and their hobbies.
• Generate a custom birthday card with an AI-generated image that reflects the hobbies provided.
• Preview, download, or share the card directly via social media or messaging platforms.

The app will use AI models for image generation and text processing, ensuring high-quality and contextually relevant outputs. It will cater to diverse user needs, including hobby-specific themes, vibrant designs, and easy sharing options.

3. Functional Requirements

• As a User, I should be able to input the recipient's name.
• As a User, I should be able to input hobbies or interests of the recipient.
• As a User, I should be able to preview the generated birthday card.
• As a User, I should be able to download the birthday card as an image or PDF.
• As a User, I should be able to share the birthday card directly via social media or messaging apps.
• As a User, I should be able to select from multiple card templates.
• As a User, I should be able to edit the text on the card before finalizing it.
• As a User, I should be able to regenerate the AI image if I am not satisfied with the first result.
• As a User, I should be able to save my favorite card designs for future use.

4. User Personas

4.1 Regular User

• Description: Individuals who want to create personalized birthday cards for their friends and family.
• Goals: Generate unique and visually appealing birthday cards quickly and easily.
• Technical Expertise: Basic familiarity with mobile and web applications.

4.2 Guest User

• Description: Users who want to try the app without creating an account.
• Goals: Explore the app's features and generate a limited number of cards.
• Technical Expertise: Basic familiarity with mobile and web applications.

4.3 Admin

• Description: The app administrator responsible for managing templates, monitoring AI model performance, and ensuring smooth app operation.
• Goals: Maintain the app's functionality, update templates, and troubleshoot user issues.
• Technical Expertise: Advanced knowledge of app management and AI tools.

5. Visuals Colors and Theme

Color Palette

• Primary Color: #FF6F61 (Coral Red) – Represents celebration and warmth.
• Secondary Color: #FFD700 (Golden Yellow) – Symbolizes joy and festivity.
• Accent Color: #4CAF50 (Green) – Adds a refreshing and vibrant touch.
• Background Color: #FFFFFF (White) – Ensures a clean and modern look.
• Text Color: #333333 (Dark Gray) – Provides excellent readability.

Theme

The app will have a festive and cheerful theme with smooth gradients and subtle animations. The design will focus on simplicity and elegance, ensuring a delightful user experience.

6. Signature Design Concept

Interactive Birthday Card Carousel with AI Animation

The Velvet-App's homepage will feature an interactive carousel of birthday cards that users can swipe through. Each card will have a live animation effect where the AI-generated image subtly morphs into different variations based on the hobbies provided. For example:

• If the hobby is "painting," the card will display a brushstroke animation that reveals the AI-generated artwork.
• If the hobby is "cycling," the card will show a dynamic animation of a bicycle wheel spinning before settling into the final image.

The carousel will include a "Create Your Card" button that pulsates gently to draw attention. Micro-interactions, such as hover effects and smooth transitions, will make the experience engaging. The background will feature a soft confetti animation to enhance the celebratory vibe.

This design concept ensures that the homepage is not only visually stunning but also interactive and memorable, leaving a lasting impression on users.

7. Non-Functional Requirements

• The app should load within 3 seconds on a standard 4G network.
• The AI image generation process should not exceed 10 seconds.
• The app should support both English and Hindi languages.
• The app must be compatible with Android, iOS, and web browsers.
• The app should ensure data security and comply with GDPR and Indian IT regulations.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL for structured data storage (e.g., user accounts, templates).
• WeaviateDB for storing and retrieving vectorized AI image data.

AI Models

• Google Nano Banana for image generation.
• GPT 5.2 for user-friendly text processing.

AI Tools

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

Orchestration

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

9. Assumptions and Constraints

• Users will have access to a stable internet connection.
• The app will primarily target users in India, so the default timezone will be IST (Indian Standard Time).
• The app will use a freemium model, with advanced features (e.g., premium templates) available via in-app purchases.
• AI-generated images will be subject to ethical guidelines to avoid inappropriate content.

10. Glossary

• AI (Artificial Intelligence): Technology used to generate images and process text inputs.
• Carousel: A rotating set of images or cards displayed on the homepage.
• Freemium Model: A pricing strategy where basic features are free, and advanced features require payment.
• Micro-Interactions: Small animations or design elements that enhance user experience.
• VectorDB: A database optimized for storing and querying vectorized data, such as AI-generated images.

End of Document