Skip to content

✨ A modern e-commerce web application built with React and TypeScript for scalable and maintainable development. 🛒🌐

Notifications You must be signed in to change notification settings

AliAshour2/Salla

Repository files navigation

🛒 Salla E-commerce Platform

Welcome to the Salla E-commerce Platform! This project is a comprehensive e-commerce application built with modern web technologies. It includes features such as product browsing, cart management, wishlist functionality, user authentication, and more.

"Img"

🚀 Features

  • 🛍️ Product Browsing: Browse through a wide range of products.

  • 🛒 Cart Management: Add, update, and remove products from your cart.

  • ❤️ Wishlist: Save your favorite products to your wishlist.

  • 🔐 User Authentication: Sign up, log in, and manage your account.

  • 🌐 Internationalization: Support for multiple languages.

  • 📱 Responsive Design: Optimized for both desktop and mobile devices.

  • "Img"

  • "Img"

  • "Img"

  • "Img"

  • "Img"

  • "Img"

🛠️ Technologies Used

  • Frontend: React, TypeScript, Redux Toolkit,Reduc persists ,Tailwind CSS , ShadCn
  • API: RESTful API
  • Authentication: JWT (JSON Web Tokens)
  • State Management: Redux Toolkit
  • Internationalization: react-i18next

📦 Installation

  1. Clone the repository:
    git clone https://github.com/your-username/salla-ecommerce.git
    cd salla-ecommerce 
    
    
    

2. Install dependencies:

npm install

3. Set up environment variables:

Create a .env file in the root directory and add the following variables:

REACT_APP_API_BASE_URL=http://localhost:5000/api

4. Run the development server:

npm start

5. Open your browser:

Navigate to http://localhost:3000 to see the application in action.


Usage

  • Browse Products: Explore the product catalog and view product details.
  • Manage Cart: Add products to your cart, update quantities, and remove items.
  • Wishlist: Add products to your wishlist for future reference.
  • User Authentication: Sign up for a new account or log in with existing credentials.

📁 Project Structure

Project Structure: Salla E-commerce

salla-ecommerce/
├── public/                     # Static assets and public files
├── src/                        # Main source code directory
│   ├── components/             # Reusable UI components
│   │   ├── AuthComponent/      # Components related to authentication
│   │   ├── NavBar/             # Navigation bar components
│   │   ├── ProductViewer/      # Product viewing components
│   │   ├── shared/             # Shared components across the app
│   │   └── ui/                 # UI-specific reusable components
│   ├── features/               # Redux features for state management
│   │   ├── auth/               # Authentication feature
│   │   ├── cart/               # Cart feature
│   │   ├── products/           # Product feature
│   │   └── wishlist/           # Wishlist feature
│   ├── hooks/                  # Custom React hooks
│   ├── pages/                  # Application pages
│   ├── services/               # API and utility services
│   │   ├── api/                # API service files
│   │   └── utils/              # Utility functions
│   ├── App.tsx                 # Root application component
│   ├── index.tsx               # Application entry point
│   └── ...                     # Other project files
├── .env                        # Environment variables
├── package.json                # Project dependencies and scripts
└── README.md                   # Project documentation 




---

### 🤝 Contributing  
Contributions are welcome! Please follow these steps to contribute:  
1. Fork the repository.  
2. Create a new branch:  
   ```bash
   git checkout -b feature/your-feature
  1. Make your changes.
  2. Commit your changes:
    git commit -m 'Add some feature'
  3. Push to the branch:
    git push origin feature/your-feature
  4. Open a pull request.

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.


📧 Contact

If you have any questions or feedback, feel free to reach out:


About

✨ A modern e-commerce web application built with React and TypeScript for scalable and maintainable development. 🛒🌐

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published