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

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

73 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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