Personal Commerce Frontend

Welcome to the Personal Commerce Frontend repository! This is the frontend application for the Personal Commerce headless commerce platform, designed to provide a flexible and dynamic user interface for e-commerce solutions.

Note that this project is in active development and should be considered pre-alpha. Use at your own risk.

---

Table of Contents

• Overview
• Features
• Technologies Used
• Getting Started
  • Prerequisites
  • Installation
  • Running the Application
• Environment Variables
• Contributing
• License

---

Overview

The Personal Commerce Frontend is the user-facing interface of the Personal Commerce platform. It interacts with the backend APIs to deliver a highly customizable e-commerce experience. This project aims to be a starting point for building personalized e-commerce applications with modern web development practices.

---

Features

• Dynamic product catalog display.
• Cart and checkout functionality.
• User authentication and account management.
• Integration with headless backend commerce APIs.
• Responsive design for mobile and desktop.
• Modular and reusable component architecture.

---

Technologies Used

• Framework: React
• State Management: Redux
• Styling: CSS Modules / SCSS
• API Communication: Axios
• Build Tool: Webpack
• Package Manager: npm

---

Getting Started

Prerequisites

Ensure you have the following installed:

• Node.js (>= 14.x)
• npm (>= 6.x)

Installation

1. Clone the repository:

   git clone https://github.com/Marclev78/personal-commerce-frontend.git

2. Navigate to the project directory:

   cd personal-commerce-frontend

3. Install dependencies:

   npm install

Running the Application

1. Start the development server:

   npm start

2. Open your browser and navigate to http://localhost:3000 (or the specified port).

---

Environment Variables

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

REACT.APP.API.BASE.URL=<backend URL>
REACT.APP.API.VERSION=1
REACT.APP.STORE_SLUG=<slug of your store>

---

Contributing

Contributions are welcome! Follow these steps to contribute:

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature/your-feature-name

3. Commit your changes:

   git commit -m "Add your feature description"

4. Push the changes to your branch:

   git push origin feature/your-feature-name

5. Submit a pull request.

---

License

This project is licensed under the Apache 2.0 License.

---

Acknowledgments

• Inspired by modern e-commerce practices.

---

Thank you for exploring the Personal Commerce Frontend project! Happy coding! 🎉