PHPackages                             brightweb/ecommerce - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. brightweb/ecommerce

ActiveLibrary[Framework](/categories/framework)

brightweb/ecommerce
===================

The BrightWeb E-Commerce package is a complete e-commerce solution built with Laravel, Livewire, HTML, CSS, and JavaScript. It provides a full-featured frontend and backend for managing and selling products.

v1.0.0(1y ago)1121MITJavaScriptPHP ^7.3|^8.0

Since Jan 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Bright11/brightweb-eommere-packge)[ Packagist](https://packagist.org/packages/brightweb/ecommerce)[ RSS](/packages/brightweb-ecommerce/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Documentation for BrightWeb E-Commerce Package
==============================================

[](#documentation-for-brightweb-e-commerce-package)

Package Overview
----------------

[](#package-overview)

The **BrightWeb E-Commerce** package is a comprehensive e-commerce solution built with Laravel, Livewire, HTML, CSS, and JavaScript. This package offers a robust frontend and backend system to efficiently manage and sell products online.

With features tailored for modern e-commerce needs, it simplifies the process of building and maintaining an online store, allowing developers to focus on enhancing user experience and business growth.

### Features:

[](#features)

- Automatic installation of Livewire.
- Simple table migration with `php artisan migrate`.
- Admin dashboard for managing categories, products, and orders.
- Support for product variations, pricing, discounts, and inventory management.
- Configurable payment gateways including PayPal, Paystack, and Pay on Delivery.
- Email notifications for order confirmations (both user and admin).
- Automatic cleanup of delivered orders after 7-9 days.
- Fully customizable frontend and backend settings.

---

Installation Instructions
-------------------------

[](#installation-instructions)

### Step 1: Install the Package

[](#step-1-install-the-package)

To install the package, use Composer:

```
composer require brightweb/ecommerce
```

### Step 2: Migrate the Database

[](#step-2-migrate-the-database)

Run the following command to create the necessary tables:

```
php artisan migrate
```

### Step 3: Start the Project

[](#step-3-start-the-project)

Start your Laravel development server with php artisan serve:

```
php artisan serve
```

Remember to comment your defalut laravel home page route for your site to use the packge home directory, to do this, navigate into routes/web.php

```
// Route::get('/', function () {
//     return view('welcome');
// });
```

### Step 4: Promote an Admin User

[](#step-4-promote-an-admin-user)

Manually promote user to admin by editing the `users` table in the database: after registration

1. Locate the user’s record.
2. Update the `role` field to `admin`.

After logging in as an admin, the Admin Dashboard will be accessible via the navigation bar.

---

Features and Functionalities
----------------------------

[](#features-and-functionalities)

### Product Management

[](#product-management)

Admins can:

- Add product categories.
- Add products with details such as:
    - Variations (e.g., size, color).
    - produts gallery.
    - Purchase price.
    - Selling price.
    - Quantity.
    - Discount.
    - coupon code.
    - Add background image optional

### Order Management

[](#order-management)

- Users receive an email confirmation upon placing an order.
- Admins receive an email notification with order details.
- Admins can process orders via the Admin Dashboard.
- Users can track their orders in their dashboard.
- Delivered orders are automatically deleted from the system after 7-9 days.

### Payment Gateway Configuration

[](#payment-gateway-configuration)

The package supports multiple payment methods:

- PayPal
- Paystack
- Pay on Delivery

Other payment methods like Stripe and Razorpay are placeholders for future implementation.

### Configuration Options

[](#configuration-options)

Run the following command to publish the configuration file:

```
php artisan vendor:publish --tag=brightwebconfig
```

The configuration file will be located at `config/brightwebconfig.php`.

#### Payment Settings

[](#payment-settings)

```
'mypayment_options' => [
    'enable_stripe' => false, // Stripe not yet implemented
    'enable_razorpay' => false, // Razorpay not yet implemented
    'enable_paypal' => true, // To disable PayPal, set it to false
    'enable_paystack' => true, // To disable Paystack, set it to false
    'enable_pay_on_delivery' => true, // To disable Pay on Delivery, set it to false
],
```

#### Currency Settings

[](#currency-settings)

```
'currency' => [
    'site_Currency' => '$',// here you can add your currency
],
```

#### Frontend Category Settings

[](#frontend-category-settings)

```
'frontend_category_settings' => [
    'show_top_categories' => true, // Show top categories, to disable it set it to false
    'show_sidebar_category' => true, // Show sidebar categories, to disable it set it to false
],
```

#### Frontend Navigation Settings

[](#frontend-navigation-settings)

- To setup the colors of your navigation

```
'frontend_navigation_settings' => [
    'navigation_bg_color' => 'black',
    'navigation_text_color' => 'white',
],
```

#### Product slider or background image Customizer

[](#product-slider-or-background-image--customizer)

```
Please select your **preference** or disable both options by setting them to false.

 If you choose "show_background_image," ensure you upload a suitable image via the admin dashboard.

Customize the image to match your design requirements.

```

```
'slider_display_option'=>[
        "show_slider"=>true,# To disabled, set it to false
        "show_background_image"=>false,# To enabled, set it to true
    ],
```

#### Frontend Site Settings

[](#frontend-site-settings)

```
'frontend_site_settings' => [
    'site_bg_color' => '#ffffff',
    'site_primary_color' => 'blue',
    'site_button_color' => 'white',
    'site_text_color' => 'gray',
],
```

#### Admin Site Settings

[](#admin-site-settings)

```
'admin_site_settings' => [
    'site_bg_color' => '#ffffff',
    'site_primary_color' => 'blue',
    'site_button_color' => 'white',
    'gradient1' => 'rgb(131,58,180)',
    'gradient2' => 'linear-gradient(90deg, rgba(131,58,180,1) 0%, rgba(253,29,29,1) 50%, rgba(252,176,69,1) 100%)',
    'counter_color' => 'white',
],
```

---

Payment Gateway Setup
---------------------

[](#payment-gateway-setup)

### PayPal

[](#paypal)

Add the following to your `.env` file:

```
PAYPAL_CLIENT_ID="your_client_id"
PAYPAL_CLIENT_SECRET="your_client_secret"
```

### Paystack

[](#paystack)

Add the following to your `.env` file:

```
PAYSTACK_SECRET_KEY="your_secret_key"
PAYSTACK_PUBLIC_KEY="your_public_key"
```

---

Run the code below to clear all cacch
-------------------------------------

[](#run-the-code-below-to-clear-all-cacch)

```
php artisan config:clear
php artisan cache:clear
```

Enable or Disable Translator
----------------------------

[](#enable-or-disable-translator)

```
  "translator"=>[
        "enable_google_translate"=>true,#Enable or Disable google translate
    ],
```

Notes
-----

[](#notes)

1. For testing purposes, an admin user cannot purchase items.
2. After registretion, To test as a user, do not promote the test email to admin.
3. Email notifications will be sent for order confirmations.
4. Regularly update your `.env` file with valid keys for payment gateways.

Email Configuration:
--------------------

[](#email-configuration)

Set up email services in the .env file. For Gmail, you can use the following configuration for testing:

```
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=youremail@domain.com
MAIL_PASSWORD="password"
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=youremail@domain.com
MAIL_FROM_NAME="${APP_NAME}"
```

The site will send an email to an admin using your MAIL\_FROM\_ADDRESS on .env

SEO Features
------------

[](#seo-features)

The package includes SEO-friendly features to optimize your site for search engines. As an admin, you can configure:

Site Name SEO Meta Tags (e.g., meta description, meta keywords) Social Media Previews (e.g., Twitter Card settings) Admin SEO Configuration Example: Twitter Title Meta Description Keywords These settings are available through the Admin Dashboard and can be adjusted in real-time.

Troubleshooting
---------------

[](#troubleshooting)

Issue: Admin Access Not Visible Ensure you’ve set the correct role to admin in the database for the user account. Issue: Payments Not Processing Double-check the credentials in your .env file for PayPal and Paystack.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](/https://opensource.org/license/).

Contributing
------------

[](#contributing)

We welcome contributions to enhance this package. Please contact us at [](mailto:chikanwazuo@gmail.com)

Thank you for choosing BrightWeb E-Commerce! If you have any questions or need support, please feel free to open an issue on GitHub.

Conclusion
----------

[](#conclusion)

The BrightWeb E-Commerce Package is an excellent tool for building scalable e-commerce sites with powerful admin and user features. Customize the frontend and backend settings to suit your needs, and easily manage orders, products, and payments.

Explore the Admin Dashboard for further customization and enhancements, and enjoy building your e-commerce site!

Support
-------

[](#support)

For support, please send us an email at [](mailto:chikanwazuo@gmail.com)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance41

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

498d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/867217b5dc6bb67627e1d9b0c4d4a639a67e617cc93c553a2ecd034522b9139a?d=identicon)[Chika](/maintainers/Chika)

---

Top Contributors

[![Bright11](https://avatars.githubusercontent.com/u/34070274?v=4)](https://github.com/Bright11 "Bright11 (21 commits)")

---

Tags

laravellaravel-packagelivewireecommerceshopping cartorder managementlaravel-livewireonline-storestorefrontlaravel ecommerceProduct Managementbrightwebecommerce-packagebrightcweb

### Embed Badge

![Health badge](/badges/brightweb-ecommerce/health.svg)

```
[![Health](https://phpackages.com/badges/brightweb-ecommerce/health.svg)](https://phpackages.com/packages/brightweb-ecommerce)
```

###  Alternatives

[mhmiton/laravel-modules-livewire

Using Laravel Livewire in Laravel Modules package with automatically registered livewire components for every modules.

236409.6k9](/packages/mhmiton-laravel-modules-livewire)[jsdecena/laracom

Laravel powered e-commerce

2.0k4.4k](/packages/jsdecena-laracom)[mati365/ckeditor5-livewire

CKEditor 5 integration for Laravel Livewire

413.9k](/packages/mati365-ckeditor5-livewire)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)