lime-1 System Requirements Document

1. Introduction

The lime-1 project aims to develop an AI Client Approval Portal specifically designed for design agencies and freelancers. This one-page application will streamline the feedback collection process, allowing users to upload designs or PDFs, receive client comments, and manage approvals or rejections with version history tracking. The solution is priced affordably between $19 and $49 per month, addressing the gap left by existing tools that are often too expensive or complex for small agencies.

2. System Overview

The lime-1 project will deliver a web-based application that simplifies the design approval process for agencies and freelancers. It will provide a user-friendly interface for uploading design files, facilitating client feedback, and managing approval workflows. The application will be accessible to users in Pakistan and globally, with pricing set in USD.

3. Functional Requirements as Story Points

• As a Design Agency, I should be able to upload design files or PDFs to the portal for client review.
• As a Client, I should be able to view uploaded designs and provide comments directly on the portal.
• As a Client, I should be able to approve or reject designs with a simple button click.
• As a Design Agency, I should be able to track version history of uploaded designs to manage revisions effectively.
• As a Freelancer, I should be able to manage multiple client projects within the portal.
• As a User, I should be able to access the portal with a subscription plan priced between $19 and $49 per month.

4. User Personas

• Design Agency: A business entity that creates visual content for clients and requires an efficient way to gather feedback and approvals.
• Freelancer: An individual offering design services independently, needing a streamlined process for client interactions.
• Client: The end-user who reviews and provides feedback on design submissions.

5. Core User Flows

• Design Agency uploads a design file -> Client receives notification -> Client reviews and comments -> Client approves/rejects -> Design Agency views feedback and version history.
• Freelancer uploads a design file -> Client reviews and comments -> Client approves/rejects -> Freelancer accesses version history for revisions.

6. Visuals Colors and Theme

• primary: #4CAF50 (Lime Green)
• primary_light: #81C784 (Light Lime Green)
• secondary: #FFEB3B (Yellow)
• accent: #FFC107 (Amber)
• highlight: #FF5722 (Deep Orange)
• bg: #F5F5F5 (Light Grey)
• surface: #FFFFFF (White)
• text: #212121 (Dark Grey)
• text_muted: #757575 (Grey)
• border: #BDBDBD (Light Grey)

7. Signature Design Concept

Interactive Design Carousel

The landing page will feature an interactive design carousel where users can drag and drop design files into a central upload area. As files are uploaded, they will animate into a rotating carousel of design thumbnails. Clients can click on any thumbnail to expand it into a full-screen view for commenting and approval. The carousel will use motion/react for smooth transitions and animations, creating an engaging and dynamic user experience.

LANDING HERO MOTION BRIEF

The hero section will feature a continuous loop animation where design files are visually transformed into a carousel of rotating thumbnails. As each thumbnail rotates to the forefront, it expands slightly, inviting interaction. The animation will be built using motion/react to ensure smooth transitions and responsiveness. The design will settle into a static state when not in use, with a clear call-to-action for uploading new designs.

8. Interaction Model & Motion Direction

• Interaction Model: Animated
• The landing page will feature moderate scroll-triggered reveals and hover transitions, enhancing user engagement without overwhelming the interface. The animated carousel will be the focal point, with spring physics applied to interactive elements for a polished feel.

9. Non-Functional Requirements

• The application must be responsive and accessible on various devices, including desktops, tablets, and smartphones.
• The system should ensure data security and privacy for all uploaded designs and client interactions.
• The application must support high availability and handle concurrent user sessions efficiently.

10. Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MySQL or MariaDB
• AI Models: GPT 5.4 for user-friendly responses
• Local Orchestration: Docker, docker-compose

11. Assumptions and Constraints

• The pricing model assumes a subscription-based service with monthly billing.
• The application will primarily target small to medium-sized design agencies and freelancers.
• The system must comply with relevant data protection regulations applicable in Pakistan and other target markets.

12. Glossary

• Design Agency: A company that provides creative services, including graphic design, branding, and visual content creation.
• Freelancer: An independent contractor offering services to clients on a project basis.
• Client: The recipient of design services who provides feedback and approvals on submitted work.