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.
- 📢 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.
- HTML, CSS: Structure and styling of web pages.
- JavaScript: Dynamic and interactive web pages.
- jQuery: Simplified DOM manipulation and animations.
- 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.
- DataTable: Interactive and dynamic tables.
- Alpine JS: Reactive and lightweight components for the frontend.
- FontAwesome: Vector icons for an enriched user interface.
- 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.
- Vite JS: Fast compilation and development tool for modern applications.
Before you begin, ensure you have met the following requirements:
- You have installed Composer
- You have installed Node.js and npm
- You have a working PHP environment
Follow these steps to set up the project locally:
-
Clone the repository:
git clone https://github.com/YoussefSelk/SB-SelBuy.git cd SB-SelBuy -
Install Composer dependencies:
composer install
-
Install npm dependencies:
npm install
-
Set up the environment variables: Copy the
.env.examplefile to.envand update the configuration as needed.cp .env.example .env php artisan key:generate
-
Run the database migrations:
php artisan migrate
-
Seed the database :
php artisan db:seed
-
Start the PHP development server:
php artisan serve
-
Compile the frontend assets:
npm run dev
Your application should now be running at http://localhost:8000.
To contribute to SelBuy, follow these steps:
- Fork this repository.
- Create a branch:
git checkout -b feature/your-feature. - Make your changes and commit them:
git commit -m 'Add some feature'. - Push to the original branch:
git push origin feature/your-feature. - Create the pull request.
This project is licensed under the MIT License.
If you want to contact me, you can reach me at [email protected].