SUDEST_MARKET

license last-commit repo-top-language repo-language-count

Developed with the software and tools below.

Lravel JavaScript PHP Vite JSON AJAX


Quick Links


Overview

Explore Draa Tafilalet's cultural treasures with our online marketplace—a digital haven connecting you to the region's artisanal crafts and culinary delights. From ceramics to spices, each item celebrates our vibrant heritage. Experience convenience with home delivery and pay upon arrival. Join us in supporting local businesses and fostering a sense of community across Morocco.


Features

features


Getting Started

Requirements

Ensure you have the following dependencies installed on your system:

  • PHP: version 8.2.*

Installation

  1. Clone the sudest_market repository:
git clone https://github.com/abdelghani1002/sudest_market
  1. Change to the project directory:
cd sudest_market
  1. Install the dependencies:
composer install
npm install
  1. Setup .env file:

cp .env.example .env

  1. Generate key:
php artisan key:generate
  1. Setup Database:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE="DB name"
DB_USERNAME="username"
DB_PASSWORD="password"
  1. Setup Mail:
MAIL_MAILER=
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="app@example.com"
MAIL_FROM_NAME="${APP_NAME}"

Running sudest_market

Use the following command to run sudest_market:

php artisan serve
npm run dev
php artisan queue:work

Contributing

Contributions are welcome! Here are several ways you can contribute:

Contributing Guidelines
  1. Fork the Repository: Start by forking the project repository to your GitHub account.
  2. Clone Locally: Clone the forked repository to your local machine using a Git client.
git clone https://github.com/abdelghani1002/sudest_market
  1. Create a New Branch: Always work on a new branch, giving it a descriptive name.
git checkout -b new-feature-x
  1. Make Your Changes: Develop and test your changes locally.
  2. Commit Your Changes: Commit with a clear message describing your updates.
git commit -m 'Implemented new feature x.'
  1. Push to GitHub: Push the changes to your forked repository.
git push origin new-feature-x
  1. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.

Once your PR is reviewed and approved, it will be merged into the main branch.