whzup/README.md
2025-07-15 18:20:27 +03:00

10 KiB

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