System Requirements Document (SRD) for shiny-ai

1. Introduction

The shiny-ai project is an advanced, AI-powered platform designed to deliver a premium, futuristic, and eco-conscious user experience. Developed for Kamlesh Yadav in India, this system will focus on providing real-time AI-generated visuals, interactive 3D product customization, and a luxurious design language. The platform will serve as the digital face of "SPONT by Edulife," a brand specializing in eco-friendly packaging and customizable notebooks.

This document outlines the system requirements for shiny-ai, ensuring alignment with the project's vision and user expectations.

2. System Overview

The shiny-ai platform will integrate cutting-edge technologies to create an interactive, intelligent, and visually stunning website. Key features include:

• Real-time AI-powered image generation and 3D rendering.
• A live product customization tool with instant previews.
• A design language that combines eco-minimalism with futuristic luxury.
• Responsive, component-based architecture for seamless performance across devices.

The platform will cater to eco-conscious users and businesses seeking premium, customizable products, with a focus on sustainability and innovation.

3. Functional Requirements

• As a User, I should be able to customize notebooks in real-time with a live 3D preview.
• As a User, I should be able to upload images and see them applied to the notebook surface instantly.
• As a User, I should be able to generate designs using AI by entering a text prompt.
• As a User, I should be able to zoom, reposition, and toggle fit/fill options for uploaded images.
• As a User, I should be able to select notebook type, size, binding, paper quality, and colors.
• As a User, I should be able to preview my customized product and submit an inquiry form.
• As a User, I should experience smooth animations, hover effects, and parallax scrolling.
• As an Admin, I should be able to manage product configurations and AI generation settings.

4. User Personas

4.1 Eco-Conscious Consumer

• Description: Individuals who prioritize sustainability and eco-friendly products.
• Goals: Customize and purchase eco-friendly notebooks with premium designs.
• Tech Proficiency: Moderate.

4.2 Small Business Owner

• Description: Entrepreneurs looking for branded, customizable packaging solutions.
• Goals: Create unique designs for their business using AI-powered tools.
• Tech Proficiency: Low to moderate.

4.3 Admin

• Description: Internal team managing product configurations and AI settings.
• Goals: Ensure smooth operation of the platform and manage user inquiries.
• Tech Proficiency: High.

5. Visuals Colors and Theme

Color Palette

• Background: #1B1F1A (deep forest green)
• Surface: #F5F0E6 (soft cream)
• Text: #FFFFFF (pure white)
• Accent: #D4AF37 (soft gold)
• Muted Tones: #A3A69E (sage gray)

This palette reflects the eco-minimal and futuristic luxury theme, with deep greens and gold accents symbolizing sustainability and premium quality.

6. Signature Design Concept

The Floating Eco-Luxury Universe

The homepage of shiny-ai will transport users into a floating eco-luxury universe. Here's what users will experience:

• Background: A dynamic 3D environment with floating eco-elements like leaves, notebooks, and packaging boxes, softly illuminated with cinematic lighting.
• Hero Section:
  • Left: Bold branding text ("SPONT by Edulife") with a call-to-action button.
  • Right: A 3D notebook model that rotates slowly, with parallax tilt responding to mouse movement.
  • Subtle floating particles and soft shadows enhance the premium feel.
• Interactive Animations:
  • Hover effects that make elements glow and lift slightly.
  • Scroll-triggered animations where eco-elements assemble into a cohesive scene.
• Micro-Interactions:
  • Buttons and icons with smooth easing and ripple effects.
  • Real-time feedback on user actions, such as uploading an image or generating a design.

This concept ensures an unforgettable first impression, blending futuristic technology with eco-conscious branding.

7. Non-Functional Requirements

• Performance: The platform must load within 3 seconds on a standard 4G connection.
• Scalability: Support up to 10,000 concurrent users without performance degradation.
• Accessibility: Comply with WCAG 2.1 AA standards for accessibility.
• Localization: Default to Indian locale settings (e.g., INR currency, IST timezone).
• Security: Use HTTPS for all communications and implement robust data encryption.

8. Tech Stack

Frontend

• React (Next.js with App Router)
• Tailwind CSS for styling
• Framer Motion for animations
• React Three Fiber for 3D rendering

Backend

• Python with FastAPI
• Litellm and Langchain for AI routing and processing

Database

• MySQL for relational data
• WeaviateDB for vector-based AI data

AI Models

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for academic or coding work
• Google Nano Banana for image generation

Orchestration

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

9. Assumptions and Constraints

• Users will have access to stable internet connections for real-time AI and 3D rendering.
• AI-generated visuals will rely on external APIs, which may have rate limits.
• The platform will initially target desktop and tablet users, with mobile optimization planned for later phases.
• Eco-friendly branding will be a core focus, influencing all design and content decisions.

10. Glossary

• AI: Artificial Intelligence.
• 3D Rendering: The process of generating a three-dimensional image or animation.
• Parallax Scrolling: A web design effect where background images move slower than foreground images.
• WCAG: Web Content Accessibility Guidelines.
• CTA: Call to Action.
• SPONT: The brand name under "Edulife" for eco-friendly products.