| LICENSE | ||
| README.md | ||
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