System Requirements Document (SRD)

Project Name: bright-ai

1. Introduction

The bright-ai project is an innovative to-do list application tailored specifically for engineers, students, and makers working on robotics, drones, and other complex builds. By leveraging AI to break down projects into actionable tasks, suggest build steps, and provide smart productivity insights, bright-ai aims to redefine how builders organize and execute their projects.

This document outlines the system requirements for bright-ai, ensuring alignment with the vision of its creator, Abhishek Sinha, and its target audience in India and beyond.

2. System Overview

bright-ai is a next-generation productivity tool designed to cater to the unique needs of robotics enthusiasts, engineers, and makers. Unlike generic to-do list apps, bright-ai focuses on project-based task management with features like:

• AI-powered task breakdown and build step suggestions.
• The ability to attach code snippets, parts lists, and diagrams to tasks.
• Progress visualization and timeline tracking for projects.
• Insights into productivity patterns and task completion trends.

The system will be accessible via web and mobile platforms, ensuring seamless usability across devices.

3. Functional Requirements

As a User:

• I should be able to create a new project and define its scope.
• I should be able to add tasks and subtasks under each project.
• I should be able to attach files like code snippets, parts lists, and diagrams to tasks.
• I should be able to view AI-suggested build steps for my projects.
• I should be able to set deadlines and priorities for tasks.
• I should be able to track my progress through visual timelines and charts.
• I should be able to receive productivity insights, such as most productive hours and time wasted.
• I should be able to view a "Reality vs Plan" comparison for my tasks.
• I should be able to activate a "Focus Mode" that shows only 3 tasks at a time.
• I should be able to earn rewards like XP and levels for completing tasks.

As an Admin:

• I should be able to manage user accounts and permissions.
• I should be able to monitor app usage statistics and user feedback.
• I should be able to update AI models and algorithms for task suggestions.

4. User Personas

1. Engineer

• Description: Professionals working on robotics, drones, or other engineering projects.
• Needs: Advanced project management tools, AI-powered task breakdown, and the ability to attach technical files.

2. Student

• Description: Students pursuing engineering or related fields who need help organizing academic and personal projects.
• Needs: Simple task management, focus mode, and gamified rewards to stay motivated.

3. Maker

• Description: Hobbyists and DIY enthusiasts working on personal projects like woodworking, electronics, or robotics.
• Needs: Project-based task organization and AI-suggested build steps.

5. Visuals Colors and Theme

Color Palette

The bright-ai app will feature a modern, tech-inspired color scheme that reflects its focus on engineering and innovation.

• Background: #1A1A2E (Deep Midnight Blue)
• Surface: #16213E (Dark Navy)
• Text: #EAEAEA (Soft White)
• Accent: #F05454 (Vibrant Coral Red)
• Muted Tones: #6C757D (Muted Gray)

This palette creates a professional yet engaging aesthetic, ideal for the target audience.

6. Signature Design Concept

Interactive Blueprint Landing Page

The homepage of bright-ai will resemble a dynamic blueprint or engineering schematic. Users will be greeted with a 3D interactive interface where:

• Blueprint Elements: Sections of the app (e.g., Projects, Tasks, Insights) appear as labeled components on a blueprint.
• Hover Animations: Hovering over a section causes it to "light up" with a glowing neon effect in the accent color (#F05454).
• Interactive Transitions: Clicking on a section zooms into that part of the blueprint, transitioning seamlessly into the corresponding app feature.
• Micro-Interactions: Tiny animations, like gears turning or circuits lighting up, add a sense of immersion.
• AI Assistant: A small, animated AI bot hovers in the corner, offering tips and suggestions as users explore the interface.

This design will make the app instantly memorable and align perfectly with its engineering-focused audience.

7. Non-Functional Requirements

• Performance: The app should load within 2 seconds on both web and mobile platforms.
• Scalability: The system should support up to 100,000 active users without performance degradation.
• Security: User data, including project files and personal information, must be encrypted using industry-standard protocols.
• Localization: The app should support English and Hindi languages to cater to the Indian audience.
• Accessibility: The app should comply with WCAG 2.1 standards for accessibility.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile

Backend

• Python with FastAPI

Database

• MySQL for structured data storage
• MongoDB for unstructured data storage (e.g., file attachments)

AI Models

• GPT 5.4 for user-friendly task breakdown and suggestions
• Claude 4.6 Opas for technical and academic assistance

AI Tools

• Litellm for LLM Routing
• Langchain for AI workflow orchestration

Orchestration

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

9. Assumptions and Constraints

• Assumptions:

  • Users will primarily access the app via mobile devices.
  • The target audience has basic familiarity with project management tools.

• Constraints:

  • The app must operate within the constraints of Indian internet speeds and device capabilities.
  • Initial development will focus on core features, with advanced features rolled out in later updates.

10. Glossary

• AI: Artificial Intelligence, used for task breakdown and suggestions.
• Blueprint: A technical drawing or schematic, used as a design metaphor for the app.
• Focus Mode: A feature that limits visible tasks to reduce distractions.
• Reality vs Plan: A feature that compares planned tasks with completed tasks.
• XP: Experience Points, used in gamification to reward users.

This document serves as the foundation for the development of bright-ai, ensuring clarity and alignment across all stakeholders. Let’s build something extraordinary, Abhishek! 🚀