AfricaExpress is an e-commerce platform built with Laravel and React.js, designed to provide a seamless shopping experience for users interested in African products.
Table of Contents Features Technologies Used Installation Setup Usage API Documentation Contributing License Features Product Catalog: Browse and search for African products. View product details, including descriptions, images, and prices. Add products to cart and wishlist. User Accounts: User registration and authentication. Profile management (update information, change password). Shopping Cart and Checkout: Add/remove products from the shopping cart. Checkout process with order summary and payment options. Order Management: View order history and status. Track shipment details. Admin Dashboard: Manage products, categories, and orders. View analytics and sales reports. Technologies Used Frontend:
React.js Axios (for API requests) React Router (for routing) Tailwind CSS (for styling) Backend:
Laravel (PHP Framework) MySQL (Database) Laravel Sanctum (Authentication) Laravel Eloquent (ORM) Other Tools:
Git (Version control) Composer (PHP dependency manager) npm (Node.js package manager) Installation To run AfricaExpress locally, follow these steps:
Clone the repository:
bash Copy code git clone cd africa-express Install PHP dependencies:
bash Copy code composer install Install JavaScript dependencies:
bash Copy code npm install Set up environment variables:
Copy .env.example to .env and configure database and other settings. Generate application key:
bash Copy code php artisan key:generate Migrate the database:
bash Copy code php artisan migrate Setup Start the Laravel development server:
bash Copy code php artisan serve Compile frontend assets (in a separate terminal):
bash Copy code npm run dev Access the application in your browser:
arduino Copy code http://localhost:8000 Usage User Registration/Login: Register as a new user or login with existing credentials. Browsing Products: Explore different categories of African products. View product details and add items to the cart or wishlist. Managing Cart and Checkout: Review items in the cart. Proceed to checkout, enter shipping details, and choose payment method. Order History: View past orders and track shipment status. API Documentation The API endpoints and their usage are documented in detail here.
Contributing Contributions are welcome! Please follow these steps:
Fork the repository and create your branch (git checkout -b feature/your-feature). Commit your changes (git commit -am 'Add new feature'). Push to the branch (git push origin feature/your-feature). Create a new Pull Request. License This project is licensed under the MIT License.