Skip to content

YoussefSelk/SB-SelBuy

Repository files navigation

SelBuy 🛒

SelBuy is a dynamic online marketplace inspired by platforms like Avito.ma and Facebook Marketplace. It allows users (sellers) to post announcements containing the products they want to sell, and other users (sellers/buyers) can contact them using email, phone, or chat inside the app.

Features ✨

  • 📢 Announcement Posting: Sellers can create detailed announcements for the products they wish to sell.
  • 📬 Contact Options: Buyers and sellers can communicate via email, phone, or an integrated chat system.
  • 💻 User Interface: Modern and responsive design with interactive elements.
  • 📊 Data Visualization: Utilize charts for data representation.

Technologies Used 💻

  • HTML, CSS: Structure and styling of web pages. HTML5 CSS3
  • JavaScript: Dynamic and interactive web pages. JavaScript
  • jQuery: Simplified DOM manipulation and animations. jQuery
    • jQuery UI: Interactive widgets for user interfaces.
    • Easing JS: Smooth animations for visual effects.
    • jQuery Migrate JS: Compatibility with older versions of jQuery.
    • ScrollUp JS: Scroll-to-top functionality.
    • jQuery Nav JS: Interactive and responsive navigation.
  • Tailwind CSS: Utility-first CSS framework for rapid and responsive design. Tailwind CSS
  • DataTable: Interactive and dynamic tables.
  • Alpine JS: Reactive and lightweight components for the frontend. Alpine JS
  • FontAwesome: Vector icons for an enriched user interface. FontAwesome
  • Animate.css: CSS animations library for visual effects.
  • FlowBite: UI components integrated with Tailwind CSS.
  • SweetAlert2: Stylish alerts for better user interaction.
  • UI Avatar: Dynamic user avatar generation.
  • Laravel Charts: Data visualization with charts.
  • Laravel (PHP): Web framework for a robust MVC structure and advanced features. Laravel
  • Vite JS: Fast compilation and development tool for modern applications. Vite

Getting Started 🚀

Prerequisites

Before you begin, ensure you have met the following requirements:

Installation 🛠

Follow these steps to set up the project locally:

  1. Clone the repository:

    git clone https://github.com/YoussefSelk/SB-SelBuy.git
    cd SB-SelBuy
  2. Install Composer dependencies:

    composer install
  3. Install npm dependencies:

    npm install
  4. Set up the environment variables: Copy the .env.example file to .env and update the configuration as needed.

    cp .env.example .env
    php artisan key:generate
  5. Run the database migrations:

    php artisan migrate
  6. Seed the database :

    php artisan db:seed

Running the Project 🏃‍♂️

  1. Start the PHP development server:

    php artisan serve
  2. Compile the frontend assets:

    npm run dev

Your application should now be running at http://localhost:8000.

Contributing 🤝

To contribute to SelBuy, follow these steps:

  1. Fork this repository.
  2. Create a branch: git checkout -b feature/your-feature.
  3. Make your changes and commit them: git commit -m 'Add some feature'.
  4. Push to the original branch: git push origin feature/your-feature.
  5. Create the pull request.

License 📜

This project is licensed under the MIT License.

Contact 📧

If you want to contact me, you can reach me at [email protected].

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published