SubReach is a comprehensive social media growth platform that connects content creators with their audience through authentic engagement strategies. The platform enables creators to increase their reach, manage campaigns, and monetize their content through a points-based engagement system.

• 🎯 Smart Campaign Management: Create and manage targeted engagement campaigns
• 💰 Points-Based Economy: Earn and spend points for authentic interactions
• 📊 Analytics Dashboard: Track performance and growth metrics
• 🔔 Real-time Notifications: Stay updated with campaign progress
• 💳 Secure Payments: Integrated Stripe payment processing
• 👑 VIP Membership: Premium features for power users
• 📱 Cross-Platform: Mobile app and web dashboard

SubReach consists of two main components:

• Framework: Flutter with Dart
• State Management: Riverpod
• Backend: Firebase (Auth, Firestore, Storage, Messaging)
• Payments: Stripe integration
• Authentication: Google Sign-In & Firebase Auth

• Framework: Next.js with TypeScript
• UI Library: Material-UI (MUI) + Tailwind CSS
• Database: Vercel Postgres
• Analytics: Custom dashboard with real-time metrics

• Flutter SDK (>= 3.5.4)
• Node.js (>= 18.0.0)
• Firebase Account with project setup
• Stripe Account for payment processing

1. Clone the repository

   git clone https://github.com/ramezlahzy/SubReach.git
   cd SubReach/SubReach

2. Install dependencies

   flutter pub get

3. Configure Firebase

   • Add your google-services.json (Android) and GoogleService-Info.plist (iOS)
   • Update firebase_options.dart with your configuration

4. Configure Stripe

   • Replace the publishable key in main.dart with your Stripe key

5. Run the application

   flutter run

1. Navigate to dashboard directory

   cd nextjs-dashboard

2. Install dependencies

   npm install
   # or
   pnpm install

3. Environment setup

   cp .env.example .env.local
   # Configure your environment variables

4. Run development server

   npm run dev
   # or
   pnpm dev

   Visit http://localhost:3000 to access the dashboard.

SubReach/
├── SubReach/                 # Flutter Mobile Application
│   ├── lib/
│   │   ├── screens/         # UI Screens
│   │   ├── services/        # API & Firebase Services
│   │   ├── providers/       # Riverpod State Management
│   │   ├── shared_widgets/  # Reusable Components
│   │   └── theme.dart       # App Theming
│   ├── android/             # Android Configuration
│   ├── ios/                 # iOS Configuration
│   └── pubspec.yaml         # Dependencies
│
├── nextjs-dashboard/        # Next.js Admin Dashboard
│   ├── app/                 # App Router Pages
│   ├── components/          # React Components
│   ├── lib/                 # Utility Functions
│   ├── models/              # Data Models
│   └── package.json         # Dependencies
│
└── README.md               # Project Documentation

• Flutter & Dart: Cross-platform mobile development
• Firebase Suite: Authentication, Firestore, Cloud Storage, Push Notifications
• Riverpod: Reactive state management
• Stripe Flutter: Payment processing
• YouTube Player: Video content integration

• Next.js: React framework with server-side rendering
• TypeScript: Type-safe development
• Material-UI: Modern React component library
• Tailwind CSS: Utility-first CSS framework
• Vercel Postgres: Serverless database

• Create targeted engagement campaigns
• Set campaign budgets and durations
• Track real-time campaign performance
• Automated campaign optimization

• Earn points through authentic engagement
• Spend points to boost your content
• Transparent point transaction history
• Fair distribution algorithms

• Priority campaign placement
• Advanced analytics access
• Exclusive features and tools
• Dedicated customer support

• Real-time engagement metrics
• Audience demographics analysis
• Campaign ROI tracking
• Growth trend visualization

• Firebase Security Rules: Secure database access
• Authentication: Multi-provider auth (Google, Email)
• Payment Security: PCI-compliant Stripe integration
• Data Encryption: End-to-end data protection

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Lead Developer: Ramez Nashaat Lahzy
• Frontend Specialist: Mark Mahrous

• 📧 Email: [email protected]
• 🔗 LinkedIn: Ramez Lahzy
• 🐛 Issues: GitHub Issues

• Android: Build APK/AAB for Google Play Store
• iOS: Build IPA for Apple App Store

• Vercel: Optimized for Next.js deployment
• Custom: Docker containerization available