Skip to content

About

No description or website provided.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›’ E-Commerce Web Application

A modern full-stack E-Commerce Web Application designed to provide a seamless online shopping experience. The application includes product browsing, user authentication, shopping cart management, checkout, order processing, and a structured backend with database integration.

The project was developed as a full-stack application with a clear separation between the frontend, backend, database layer, and supporting services.


๐Ÿš€ Live Project

๐Ÿ”— GitHub Repository: https://github.com/umeshkumar-git/e-commerce-app


๐Ÿ“Œ Project Overview

This project demonstrates the development of a complete e-commerce platform from frontend UI to backend APIs and database management.

The application focuses on:

  • Modern and responsive user interface
  • Product discovery and browsing
  • User authentication
  • Shopping cart functionality
  • Checkout and order management
  • Backend API development
  • Database persistence
  • Structured application architecture
  • Secure environment configuration

โœจ Key Features

๐Ÿ‘ค User Features

  • User registration and authentication
  • User login/logout
  • Browse available products
  • View product details
  • Add products to cart
  • Update product quantities
  • Remove products from cart
  • Checkout workflow
  • Order creation
  • Order management

๐Ÿ›๏ธ Product Management

  • Product listing
  • Product details
  • Product categorization
  • Product data stored in the database
  • Dynamic product retrieval through backend services

๐Ÿ›’ Shopping Cart

  • Add products to cart
  • Increase/decrease quantity
  • Remove products
  • Calculate cart totals
  • Persistent cart-related data

๐Ÿ“ฆ Order Management

  • Create orders during checkout
  • Store customer/order information
  • Maintain order records
  • Retrieve order information from the database

๐Ÿ” Authentication & Security

  • User authentication
  • Protected application functionality
  • Environment-based configuration
  • Secure handling of sensitive credentials

๐Ÿ—๏ธ Application Architecture

                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚       Client         โ”‚
                    โ”‚      Frontend        โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                               โ”‚
                               โ”‚ API Requests
                               โ–ผ
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚       Backend        โ”‚
                    โ”‚   Server / API Layer โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                               โ”‚
                               โ–ผ
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚   Database Layer     โ”‚
                    โ”‚       Prisma         โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                               โ”‚
                               โ–ผ
                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚      Database        โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿงฐ Tech Stack

Frontend

  • React
  • TypeScript
  • Modern CSS / UI styling
  • Responsive design
  • Component-based architecture

Backend

  • Node.js
  • API-based backend architecture
  • Server-side business logic
  • REST/API communication

Database

  • PostgreSQL
  • Prisma ORM

Development Tools

  • Git
  • GitHub
  • npm
  • Environment variables
  • TypeScript

๐Ÿ“‚ Project Structure

e-commerce-app/
โ”‚
โ”œโ”€โ”€ backend/
โ”‚   โ””โ”€โ”€ Backend application and API logic
โ”‚
โ”œโ”€โ”€ frontend/
โ”‚   โ””โ”€โ”€ Frontend application
โ”‚
โ”œโ”€โ”€ lib/
โ”‚   โ””โ”€โ”€ Shared libraries and utilities
โ”‚
โ”œโ”€โ”€ prisma/
โ”‚   โ””โ”€โ”€ Database schema and Prisma configuration
โ”‚
โ”œโ”€โ”€ docs/
โ”‚   โ””โ”€โ”€ Project documentation
โ”‚
โ”œโ”€โ”€ prisma.config.ts
โ”œโ”€โ”€ .gitignore
โ””โ”€โ”€ README.md

๐Ÿ”„ Application Workflow

1. User Visits the Application

The user accesses the e-commerce frontend and can browse the available products.

2. Product Discovery

Products are retrieved from the backend and displayed through the frontend interface.

3. Authentication

Users can create an account or log in to access account-related functionality.

4. Cart Management

Users can add products to their shopping cart and modify quantities before checkout.

5. Checkout

The selected products and required order information are submitted to the backend.

6. Order Creation

The backend processes the request and stores the order information in the database.

7. Database Persistence

Prisma handles communication between the application and the PostgreSQL database.


๐Ÿ—„๏ธ Database

The project uses Prisma ORM as the database access layer.

Prisma provides:

  • Type-safe database queries
  • Database schema management
  • Structured data models
  • Easier database migrations
  • Strong integration with TypeScript

The Prisma-related configuration is maintained inside the project's prisma directory and root configuration.


โš™๏ธ Installation & Setup

Prerequisites

Make sure you have installed:

  • Node.js
  • npm
  • PostgreSQL database
  • Git

1. Clone the Repository

git clone https://github.com/umeshkumar-git/e-commerce-app.git

cd e-commerce-app

2. Install Dependencies

Install dependencies for the frontend and backend:

cd frontend
npm install

Then:

cd ../backend
npm install

If your project uses dependencies from the root directory, install them there as well:

cd ..
npm install

๐Ÿ” Environment Variables

Create the required .env files according to your local configuration.

Example:

DATABASE_URL="your_database_connection_string"

NEXTAUTH_URL="http://localhost:3000"

NEXTAUTH_SECRET="your_secret_key"

If payment functionality is configured:

RAZORPAY_KEY_ID="your_razorpay_key"
RAZORPAY_KEY_SECRET="your_razorpay_secret"

Never commit .env files or secret keys to GitHub.


๐Ÿ—ƒ๏ธ Prisma Setup

After configuring the database connection:

npx prisma generate

Run the required database migration:

npx prisma migrate dev

You can inspect the database using:

npx prisma studio

โ–ถ๏ธ Running the Project

Start the backend:

cd backend
npm run dev

Start the frontend in another terminal:

cd frontend
npm run dev

Then open the local development URL shown by the frontend development server.


๐Ÿ”Œ API Layer

The backend is responsible for handling application requests such as:

User Authentication
       โ”‚
       โ–ผ
Product Requests
       โ”‚
       โ–ผ
Cart Operations
       โ”‚
       โ–ผ
Checkout
       โ”‚
       โ–ผ
Order Processing
       โ”‚
       โ–ผ
Database

This separation keeps the frontend focused on presentation and user interaction while the backend handles business logic and data operations.


๐ŸŽฏ Project Goals

The main goals of this project were to:

  • Build a complete full-stack e-commerce application
  • Understand frontend/backend integration
  • Implement database-driven functionality
  • Work with Prisma ORM
  • Build reusable frontend components
  • Develop backend APIs
  • Handle authentication and application security
  • Understand real-world e-commerce workflows
  • Practice production-oriented project structure

๐Ÿง  What I Learned

Through this project, I gained practical experience in:

  • Full-stack web application development
  • React and TypeScript
  • Backend API development
  • Database design
  • Prisma ORM
  • PostgreSQL
  • Authentication
  • API integration
  • Environment configuration
  • Git and GitHub
  • Debugging full-stack applications
  • Structuring scalable web applications

๐Ÿ”ฎ Future Improvements

Possible improvements for future versions include:

  • Advanced product search
  • Product filtering and sorting
  • Wishlist functionality
  • Product reviews and ratings
  • Order tracking
  • Admin dashboard
  • Inventory management
  • Image optimization
  • Email notifications
  • Payment gateway improvements
  • Automated testing
  • CI/CD pipeline
  • Production deployment
  • Performance optimization

๐Ÿ“ธ Screenshots

Add screenshots of the application here.

docs/
โ”œโ”€โ”€ home.png
โ”œโ”€โ”€ products.png
โ”œโ”€โ”€ product-details.png
โ”œโ”€โ”€ cart.png
โ”œโ”€โ”€ checkout.png
โ””โ”€โ”€ orders.png

Example:

![Home Page](docs/home.png)

![Products Page](docs/products.png)

![Shopping Cart](docs/cart.png)

![Checkout](docs/checkout.png)

๐Ÿ‘จโ€๐Ÿ’ป Author

Umesh Kumar Shah

Computer Science & Engineering Student Full-Stack Developer

GitHub: https://github.com/umeshkumar-git


๐Ÿ“„ License

This project is intended for educational and portfolio purposes.


โญ Support

If you found this project useful or interesting, consider giving the repository a โญ on GitHub.


Built with โค๏ธ by Umesh Kumar Shah

About

No description or website provided.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages