B8 Network Platform

🌟 B8 Network is an integrated business solutions and sports league platform that connects businesses and individuals across marketing, sports leagues, fashion, automotive, and entertainment sectors.

📖 Table of Contents

• Overview
• Features
• Tech Stack
• Prerequisites
• Installation
• Deployment
• Environment Variables
• Testing
• Project Structure
• Contributing
• License
• Security
• Contact
• Acknowledgments

🎯 Overview

B8 Network is revolutionizing the way businesses and individuals connect across multiple sectors. Our platform integrates:

Business Unit	Description	Status
🏆 B8 League	Professional sports management	Live
📈 Innov8	Digital marketing solutions	Live
🚗 B8 Car Club	Automotive community	Beta
👕 B8 Clothing	Fashion & merchandise	Coming Soon
🎭 BGr8	Entertainment & events	Live

🚀 Features

Click to expand feature list

Core Features

• ✨ Professional networking and business solutions
• 🏆 Sports league management
• 📊 Marketing services (Innov8)
• 🚗 Automotive community (B8 Car Club)
• 👕 Fashion and merchandise (B8 Clothing)
• 🎉 Entertainment and events (BGr8)

Technical Features

• 🔐 Secure authentication
• 💳 Secure payment processing with Stripe
• 📱 PWA support
• 🎨 Responsive design
• 📊 Analytics integration
• 🔄 Real-time updates
• 💰 Donation system with Stripe Checkout

🛠️ Tech Stack

Our platform is built with modern technologies:

graph TD
    A[Frontend] --> B[React + TypeScript]
    A --> C[Vite]
    D[Backend Services] --> E[Firebase]
    E --> F[Authentication]
    E --> G[Firestore]
    E --> H[Storage]
    I[Analytics] --> J[Google Analytics]
    K[Payments] --> L[Stripe]
    L --> M[Stripe Checkout]
    L --> N[Stripe Webhooks]

Loading

📋 Prerequisites

Before you begin, ensure you have:

• Node.js (v16.x or higher)
• npm (v8.x or higher)
• Firebase account and project
• Stripe account with API keys
• Stripe CLI (for webhook testing)

🔧 Installation

Step-by-step installation guide

1. Clone the repository:

   git clone https://github.com/yourusername/b8-network.git
   cd b8-network

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root directory:

   VITE_FIREBASE_API_KEY=your_api_key
   VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
   VITE_FIREBASE_PROJECT_ID=your_project_id
   VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket
   VITE_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id
   VITE_FIREBASE_APP_ID=your_app_id
   VITE_FIREBASE_MEASUREMENT_ID=your_measurement_id
   VITE_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
   VITE_STRIPE_SERVER_URL=your_stripe_server_url

4. Set up Stripe server environment: Create a .env file in the stripe directory:

   STRIPE_SECRET_KEY=your_stripe_secret_key
   STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret
   PORT=3001
   CLIENT_URL=http://localhost:5173

5. Start the development servers:

   # Start the main application
   npm run dev
   
   # Start the Stripe server (in a separate terminal)
   cd stripe && node server.js

🚀 Deployment

Deployment instructions

Production Build

npm run build

Preview Production Build

npm run preview

📝 Environment Variables

Required environment variables:

View all environment variables

Variable	Description	Required
VITE_FIREBASE_API_KEY	Firebase API Key	✅
VITE_FIREBASE_AUTH_DOMAIN	Firebase Auth Domain	✅
VITE_FIREBASE_PROJECT_ID	Firebase Project ID	✅
VITE_FIREBASE_STORAGE_BUCKET	Firebase Storage Bucket	✅
VITE_FIREBASE_MESSAGING_SENDER_ID	Firebase Messaging Sender ID	✅
VITE_FIREBASE_APP_ID	Firebase App ID	✅
VITE_FIREBASE_MEASUREMENT_ID	Firebase Measurement ID	✅
VITE_STRIPE_PUBLISHABLE_KEY	Stripe Publishable Key	✅
VITE_STRIPE_SERVER_URL	Stripe Server URL	✅
STRIPE_SECRET_KEY	Stripe Secret Key (server)	✅
STRIPE_WEBHOOK_SECRET	Stripe Webhook Secret (server)	✅

🧪 Testing

# Run unit tests
npm run test

# Run end-to-end tests
npm run test:e2e

# Run tests in CI environment
npm run test:ci

📦 Project Structure

View project structure

b8-network/
├── 📁 src/                    # Source files
│   ├── 📱 components/        # React components
│   ├── 📄 pages/            # Page components
│   ├── 🎣 hooks/            # Custom React hooks
│   ├── 🌍 context/          # React context providers
│   ├── 🔌 services/         # API and service integrations
│   ├── 🛠️ utils/            # Utility functions
│   ├── 📝 types/            # TypeScript type definitions
│   └── 🎨 assets/           # Static assets
├── 📂 public/               # Public static files
├── 🧪 tests/                # Test files
├── 📚 docs/                 # Documentation
└── 💳 stripe/               # Stripe server implementation
    ├── server.js           # Express server setup
    ├── stripe.js           # Stripe integration logic
    └── config.js           # Server configuration

🤝 Contributing

We welcome contributions! Please read our Contributing Guide for details.

Quick contribution steps

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

📄 License

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

🔒 Security

For security concerns, please email security@b8network.co.uk

📧 Contact

Ways to reach us

• 🌐 Website: b8network.co.uk
• 📧 Email: contact@b8network.co.uk
• 🐦 Twitter: @B8Network
• 💼 LinkedIn: B8 Network

🙏 Acknowledgments

Special thanks to

• 👥 All our contributors and community members
• 🌟 Open source projects we depend on
• 🧪 Our beta testers and early adopters

---

Made with ❤️ by the B8 Network Team

Report Bug · Request Feature