honest-theme

Introduction

The "honest-theme" project is focused on developing a modern AI-powered earning application called "CashFlow AI." This application is designed with a premium dark theme UI and a futuristic design, specifically targeting students as the primary user demographic. The app will feature a comprehensive referral earning system and seamless social media integration for sharing.

System Overview

"CashFlow AI" is an innovative platform that leverages AI technology to provide students with opportunities to earn money through various activities. The system will include a robust referral program, allowing users to generate unique referral codes and links. The application will also feature one-click invite sharing buttons for popular social media platforms and messaging services, enhancing user engagement and reach.

Functional Requirements

• As a User, I should be able to access a premium dark theme UI.
• As a User, I should be able to generate a unique referral code and referral link.
• As a User, I should be able to share my referral link via one-click invite buttons for WhatsApp, Telegram, Instagram, Facebook, and SMS.

User Personas

• Student: The primary user of "CashFlow AI," looking for flexible earning opportunities. They are tech-savvy and active on social media platforms.

Visuals Colors and Theme

• primary: #1A1A2E (Deep Indigo)
• primary_light: #2E2E4D (Lighter Indigo)
• secondary: #E94560 (Crimson)
• accent: #0F3460 (Vibrant Blue)
• highlight: #F9D342 (Gold)
• bg: #121212 (Dark Background)
• surface: rgba(26, 26, 46, 0.8)
• text: #FFFFFF (White)
• text_muted: #B0B0B0 (Muted Gray)
• border: rgba(233, 69, 96, 0.2)

Signature Design Concept

The homepage of "CashFlow AI" will feature an interactive galaxy map where each star represents a different feature or section of the app. Users can click on a star to open a task card, drag to rotate the cluster, and hover to highlight connections between different features. This dynamic and engaging interface will be built using @react-three/fiber and @react-three/drei for 3D interactions, providing a unique and memorable user experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the content. Decorative elements will move at varying speeds, while the main content remains in the natural flow. This approach will enhance the storytelling and visual appeal of the app, making a strong first impression on users.

Non-Functional Requirements

• The application must be responsive and accessible on both desktop and mobile devices.
• The system should handle a high volume of users and referral transactions efficiently.
• Data privacy and security must be ensured for all user information and transactions.

Tech Stack

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

Assumptions and Constraints

• The application will primarily target students in India, considering local preferences and behaviors.
• The app will operate within the constraints of the free plan, focusing on maximizing available resources.

Glossary

• AI: Artificial Intelligence
• UI: User Interface
• Referral Code: A unique identifier used to track referrals
• Parallax: A scrolling technique that creates an illusion of depth