diff --git a/README.md b/README.md index 5aa6da0..bd2cc26 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,236 @@ # whzup Whzup +AI Agent Prompt: Whzup - Integrated Social & Messaging App +Project Title: Whzup - All-in-One Social & Messaging Mobile Application + +I. Objective: +Develop a comprehensive, intuitive, and aesthetically pleasing mobile application, provisionally named "Whzup," that seamlessly integrates the core functionalities of Facebook, WhatsApp, Instagram, and X (formerly Twitter) into a single, unified platform. The primary goal is to create a simplified, beautiful, and highly engaging user experience that eliminates the need for users to switch between multiple apps for their social networking and communication needs. + +II. Core Principles & Design Philosophy: + +Simplicity & Intuition: The app must be incredibly easy to navigate, even with its extensive feature set. UI/UX design should prioritize clarity, minimalism, and a shallow learning curve. + +Aesthetics & Beauty: The visual design must be modern, clean, and appealing. Consider a harmonious color palette, elegant typography, and smooth animations. The "beautiful app" aspect is paramount. + +Seamless Integration: Features from different platforms should not feel tacked on but organically woven together. Interactions should flow naturally between different modules (e.g., seeing a friend's post and being able to instantly message them about it). + +Performance & Responsiveness: The app must be fast, fluid, and highly responsive, even with a large amount of content and active users. Minimize loading times and ensure smooth scrolling and transitions. + +Privacy & Security: Implement robust privacy controls and top-tier security measures for all user data, communications, and content. Users should have granular control over their privacy settings. + +Customization (User Experience): Allow for a degree of user customization, such as notification preferences, theme options (light/dark mode), and content filtering, where appropriate. + +III. Feature Breakdown & Integration: + +The AI agent should understand and implement the following key features, focusing on their integration and simplification: + +A. User Profiles & Identity (Facebook/Instagram/X Inspired): + +Unified Profile: A single user profile that encompasses all aspects: + +Profile Picture/Avatar: Customizable, with options for animated avatars. + +Bio/About Section: Rich text support, links, and hashtags. + +Contact Info: Optional, privacy-controlled. + +Followers/Following Model: Similar to Instagram/X, allowing users to follow public profiles and connect as "friends" with mutual consent. + +Public/Private Profile Options: Granular control over who can see posts, stories, and send messages. + +Badges/Achievements (Optional): Gamification elements for engagement. + +Activity Log: A unified view of user's posts, shared content, and interactions. + +Discovery: Mechanisms to find and connect with friends, family, and public figures (e.g., search, suggestions based on contacts, interests). + +B. Feeds & Content Discovery (Facebook/Instagram/X Inspired): + +Personalized Home Feed: A single, algorithmically-driven feed that combines: + +Posts: Text, photos, videos (short & long-form), links, polls, similar to Facebook/X. + +Stories: Ephemeral content (photos/videos) with filters, stickers, text, and drawing tools, similar to Instagram/Facebook Stories. + +Reels/Short Videos: A dedicated section for short, engaging vertical videos, similar to Instagram Reels/TikTok. + +Live Streams: Ability to initiate and watch live video broadcasts. + +Content Creation Tools: + +Intuitive Post Composer: Easy access to text, photo, video, and live stream options. + +Advanced Photo/Video Editor: Built-in tools for cropping, filters, adjustments, text overlays, and music for Stories and Reels. + +Polls, Questions, Quizzes: Interactive elements for posts. + +Engagement: + +Reactions: A rich set of reactions (e.g., like, love, laugh, etc.) for all content types. + +Comments: Threaded comments with rich media support (photos, GIFs, voice notes). + +Sharing: Easy options to share posts to stories, direct messages, or external platforms. + +Repost/Quote: Ability to repost content with or without additional commentary (X-like functionality). + +Exploration/Discovery Tab: A dedicated section for trending topics, popular content, suggested profiles, and interests (similar to Instagram's Explore or X's Trends). + +Hashtag & Topic Following: Users can follow specific hashtags or topics to see related content. + +C. Messaging & Communication (WhatsApp/Facebook Messenger Inspired): + +Unified Inbox: A single, streamlined inbox for all messages. + +One-to-One Chat: + +Rich Text Messaging: Standard text, emojis, GIFs. + +Media Sharing: Photos, videos, documents, audio messages, contact cards, location sharing. + +Voice & Video Calls: High-quality, reliable individual voice and video calls. + +Ephemeral Messages: Optional disappearing messages (like WhatsApp's view once). + +Reactions to Messages: React to individual messages. + +Reply to Specific Messages: Threaded replies within chats. + +Group Chat: + +Robust Group Management: Admin controls, participant lists, group info. + +Large Group Support: Ability to handle groups with many members. + +Group Voice & Video Calls: Conference calling capabilities. + +Broadcast Lists: Send messages to multiple contacts simultaneously without creating a group. + +Status Updates (WhatsApp Status Inspired): Ephemeral text, photo, or video updates visible to selected contacts for 24 hours. Integrated directly into the messaging section or a dedicated tab. + +Direct Messaging from Feeds: Seamlessly transition from viewing a post/story to directly messaging the creator or sharing it with a contact. + +End-to-End Encryption: All one-to-one and group communications must be end-to-end encrypted by default. + +D. Notifications & Alerts: + +Centralized Notification Hub: A single place to view all notifications (new messages, likes, comments, mentions, new followers, live streams, etc.). + +Granular Notification Settings: Users can customize notification types, sounds, and vibrations. + +In-App Alerts: Subtle visual cues for new activity. + +E. Search Functionality: + +Universal Search Bar: Ability to search for: + +Users/Profiles + +Posts/Content (by keywords, hashtags) + +Messages (within chats) + +Groups + +Trending topics + +F. Settings & Privacy: + +Comprehensive Privacy Controls: + +Who can see my profile? (Public, Friends, Custom) + +Who can see my posts/stories? + +Who can send me messages/friend requests? + +Location sharing controls. + +Activity status visibility. + +Blocking and muting options. + +Account Management: Profile editing, password changes, two-factor authentication. + +Data Management: Options to download user data. + +Notification Preferences: As mentioned above. + +App Theme: Light/Dark mode, potentially custom accent colors. + +IV. Technical Requirements & Considerations: + +Platform: Native iOS (Swift/ SwiftUI) and Android (Kotlin/Jetpack Compose) development for optimal performance and user experience. Cross-platform frameworks (e.g., React Native, Flutter) could be considered only if they can guarantee native-level performance and UI fluidity. + +Backend: Scalable, secure, and robust backend infrastructure capable of handling millions of concurrent users and petabytes of data (e.g., microservices architecture, cloud-based solutions like AWS, Google Cloud, Azure). + +Database: Efficient database solutions for real-time data, user profiles, content, and messages (e.g., NoSQL for flexibility, SQL for relational data). + +Real-time Communication: WebSockets or similar protocols for instant messaging and live features. + +Content Delivery Network (CDN): For fast and efficient delivery of media (images, videos). + +Security: Implement OAuth 2.0 for authentication, end-to-end encryption for messaging (e.g., Signal Protocol), regular security audits, and protection against common vulnerabilities (OWASP Top 10). + +Scalability: Design for horizontal scalability from the outset. + +Analytics & Crash Reporting: Integrate tools for monitoring app performance, user engagement, and crash reporting (e.g., Firebase Analytics, Crashlytics). + +Push Notifications: Reliable push notification service integration. + +V. UI/UX Design Directives: + +Clean & Minimalist Interface: Avoid clutter; prioritize content visibility. + +Intuitive Navigation: Consider a bottom navigation bar for primary sections (e.g., Home/Feed, Explore, Messages, Profile), and contextual menus for secondary actions. + +Consistent Design Language: Maintain a unified visual style across all screens and components. + +Accessibility: Ensure the app is accessible to users with disabilities (e.g., screen reader support, customizable text sizes). + +Onboarding: A brief and engaging onboarding process that explains key features without overwhelming the user. + +Error Handling: Graceful error handling and informative user feedback. + +Animations & Transitions: Subtle, smooth animations to enhance the user experience and provide visual feedback. + +VI. Monetization Strategy (Future Consideration, but Design for Flexibility): + +No immediate monetization is required, but the architecture should allow for future integration of: + +Optional in-app purchases (e.g., premium features, stickers). + +Non-intrusive advertising (e.g., sponsored posts within the feed, clearly marked). + +Subscription models for advanced features. + +VII. Deliverables: + +Detailed UI/UX Wireframes & Mockups: For all core screens and user flows. + +Technical Architecture Document: Outlining the proposed backend, database, and overall system design. + +Native Mobile Applications: Fully functional iOS and Android applications. + +Backend API & Services: All necessary APIs to support mobile app functionality. + +Comprehensive Test Plan & Results: Unit tests, integration tests, end-to-end tests. + +Deployment Strategy: Plan for app store submission and continuous integration/continuous deployment (CI/CD). + +User Manual/Documentation (Optional, but helpful): For app usage and administration. + +VIII. Success Metrics: + +User Retention Rate + +Daily/Monthly Active Users (DAU/MAU) + +User Engagement (time spent in app, number of posts, messages sent) + +App Store Ratings and Reviews + +Performance Benchmarks (loading times, responsiveness) + +Crash-free user sessions +