React Sneakers

Sneaker store and more =)

Table of Contents

1. About The Project
   • Built With
   • App diagram
2. Getting Started
   • Prerequisites
   • Installation
   • Environment Variables

About The Project

React Sneakers is a modern online sneaker store with the ability to search, sort and view products in detail. Users can add sneakers to the cart and favorites without authorization, and in their personal profile - manage data and track orders. Placing an order is accompanied by confirmation by email. The application supports pagination, size and quantity selection, providing a convenient and flexible user experience.

Built With

Backend:

• 
• 
• 
• 
• 
• 
• 
• 

Frontend:

• 
• 
• 
• 
• 
• 
• 
• 

Resource server:

• 

Cache:

• 

Build:

• 

(back to top)

App diagram

(back to top)

Getting Started

Prerequisites

Before running the project, you need to install and run docker and docker-compose (see more details here)

Installation

1. Clone the repo

   git clone https://github.com/Rav316/react-sneakers.git

2. create a .env file and specify the environment variables as per the example in .public.env.
3. Run application in docker

    docker-compose up

Environment Variables

Variable	Description	Example
POSTGRES_DB_NAME	Name of the PostgreSQL database used by the application	sneakers_db
POSTGRES_USERNAME	Username for connecting to the PostgreSQL database	postgres
POSTGRES_PASSWORD	Password for connecting to the PostgreSQL database	mysecretpassword
MAIL_USERNAME	Username (usually an email) for the SMTP service used to send emails	noreply@example.com
MAIL_PASSWORD	Password or API key for the SMTP service	smtp_app_password

(back to top)

Documentation

See documentation in Swagger-UI when project is running.

(back to top)

---

README created 08/07/2025