MERN Stack POS Application - Front End

This repository contains the front end of the MERN Stack POS Application. The front end is built using React and provides the user interface for the POS system.

Table of Contents

• Installation
• Usage
• Features
• Contributing
• Technologies Used
• Images/Screenshots
• Environment Variables
• License

Installation

1. Clone the repository:

   git clone https://github.com/mesubasi/pos-app-frontend.git
   cd pos-app-frontend

2. Install dependencies:

   npm install

3. Set up environment variables:

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

   VITE_API_URL=http://localhost:5000/api
   VITE_AUTH_SECRET=your-auth-secret
   VITE_OTHER_CONFIG=your-other-config

4. Start the development server:

   npm run dev

   The application will start on http://localhost:5173.

Usage

• Navigate to http://localhost:5173 in your web browser.
• Use the provided interface to manage sales, inventory, and other POS features.

Features

• User Authentication: Secure login and registration.
• Inventory Management: Add, update, and delete inventory items.
• Sales Management: Track and manage sales transactions.
• Reports: Generate sales and inventory reports.

Technologies Used

• React
• Vite
• Redux
• React Router
• Ant Design
• Tailwind CSS
• Google Fonts

Images/Screenshots

Here are some screenshots of the application:

Login Page

Dashboard

Inventory Management

Sales Management

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -m 'Add new feature').
5. Push to the branch (git push origin feature-branch).
6. Open a Pull Request.

Environment Variables

The following environment variables are required for the application to run:

• VITE_API_URL: The base URL for the API.
• VITE_AUTH_SECRET: The secret key for authentication.
• VITE_OTHER_CONFIG: Any other configuration needed.

License

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