🚀 Overview

SocialV is a production-ready Flutter social networking app powered by a BuddyPress (WordPress) backend.
It provides modern community features—activity feeds, friends/follows, groups, profiles, messaging, and notifications—through the WordPress REST API.
Built for agencies, indie founders, schools, clubs, NGOs, and creators who want to launch a branded social app quickly without building a backend from scratch.

Experience: The architecture mirrors real-world communities (campus groups, member clubs, local business networks),
emphasizing smooth onboarding, reliable push notifications, and content moderation flows that reduce admin overhead.

✨ Key Features

• 📰 Activity Feed: post text, images, links; like, comment, report, and share.
• 👤 User Profiles: avatars, cover photos, profile fields, privacy & visibility controls.
• 🤝 Friends & Follows: requests, accept/decline, suggestions, and blocking.
• 👥 Groups: public/private/hidden groups with roles (owner, mod, member) and group feeds.
• 💬 Messaging: 1:1 and group chat (BuddyPress Messages / optional Firebase RTM bridge).
• 🔔 Notifications: in-app + push (FCM/APNs), granular settings per event type.
• 🔎 Search & Discovery: users, groups, and posts with filters & sort options.
• 🛡️ Moderation: report content/users, admin review queue, keyword filters (hooks).
• 🧩 Pluggable Extensions: hooks for WooCommerce membership, LMS, and gamification badges.
• 🌐 i18n & RTL: localization-ready strings; RTL UI support.
• 🧭 Onboarding: multi-step signup, profile completion, interests-based recommendations.
• 📱 Responsive UI: adaptive layouts for phones and tablets, dark mode ready.
• 🔐 Security: JWT auth (WP plugin), rate-limits, CSRF-safe flows, secure media uploads.
• 📈 Analytics: optional Firebase Analytics events & crash reporting.

⚙️ Technical Stack (Expertise)

• Mobile App: Flutter 3.x (Dart 3), Null Safety, Provider/Bloc (state), Dio/HTTP client.
• Backend: WordPress 6.x with BuddyPress plugin; WP REST API; JWT Authentication plugin.
• Database: MySQL 8 / MariaDB 10.6+.
• Push: Firebase Cloud Messaging (Android) & Apple Push Notification service (iOS).
• Media: WordPress Media Library (S3-compatible offload optional).
• Server Requirements: PHP 8.1+, Nginx/Apache, HTTPS/TLS 1.2+, PHP extensions: json, curl, mbstring, intl, gd/imagemagick.
• Tooling: Flutter SDK, Android Studio/Xcode, Node 18+ (asset pipelines optional), Composer for WP plugins.

🧩 Installation Guide

1. Prepare WordPress: Install WP 6.x, enable HTTPS, install BuddyPress and a JWT Authentication plugin; configure permalinks and CORS headers for the app domain.
2. Create API Keys: Set JWT secret in wp-config.php; create an admin API user for setup.
3. Configure SocialV App: In lib/core/config.dart, set WP_BASE_URL, JWT endpoints, and media paths.
4. Branding: Replace app icon/splash, update colors/typography in theme.dart; add localized strings in l10n/.
5. Build Mobile: flutter pub get → flutter build apk --release / flutter build ios.
6. Push Notifications: Add google-services.json/GoogleService-Info.plist, configure FCM/APNs, and test topic/user notifications.
7. Go Live: Harden WP (security plugin, WAF/CDN), enable object cache, and configure media offload if needed.

📦 Deliverables

• Flutter source code (modules for feed, profiles, groups, chat, notifications).
• WordPress integration layer (REST endpoints mapping, JWT auth middleware).
• Sample WP config notes & recommended plugins list.
• Design system: themes, typography, components, icons, and localization files.
• Build scripts, environment samples (.env.sample / config.dart template).
• API documentation (endpoint map) + Postman collection.
• README, CHANGELOG, and GPL v3 license file.

📱 Supported Platforms

• Android: 8.0 (API 26)+
• iOS: 13+ (Xcode 15+)
• Server: Linux (Ubuntu 22.04 LTS recommended), Docker-ready; macOS/Windows for local development.

👨‍💻 Original Developer Credit (Authoritativeness)

This package credits the original commercial author. Please support them on their marketplace profile:
CodeCanyon – Original Author.

🔒 Disclaimer (Trustworthiness)

This source code is redistributed under the GPL v3 license for educational evaluation and lawful production use subject to GPL terms.
We are not affiliated with WordPress, BuddyPress, or the original vendor; all trademarks are the property of their respective owners.
Production deployment requires proper server hardening, secure JWT configuration, and adherence to platform and regional regulations.