https://github.com/divith123/e-commerce
E-Commerce is a modern, full-featured online shopping platform built with Next.js, React, Prisma, and Tailwind CSS. It offers a seamless user experience with secure authentication, product browsing, cart management, and order processing.This project is ideal for learning or launching an online store.
https://github.com/divith123/e-commerce
ecommerce nextjs sql typescript
Last synced: about 1 month ago
JSON representation
E-Commerce is a modern, full-featured online shopping platform built with Next.js, React, Prisma, and Tailwind CSS. It offers a seamless user experience with secure authentication, product browsing, cart management, and order processing.This project is ideal for learning or launching an online store.
- Host: GitHub
- URL: https://github.com/divith123/e-commerce
- Owner: Divith123
- License: mit
- Created: 2025-01-09T07:21:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-19T15:39:19.000Z (about 1 year ago)
- Last Synced: 2025-10-29T04:40:45.285Z (5 months ago)
- Topics: ecommerce, nextjs, sql, typescript
- Language: TypeScript
- Homepage:
- Size: 19 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# E-Commerce Application
A comprehensive and scalable E-Commerce platform built with modern web technologies.
## Table of Contents
- [Introduction](#introduction)
- [Features](#features)
- [Demo](#demo)
- [Installation](#installation)
- [Usage](#usage)
- [Project Structure](#project-structure)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [License](#license)
## Introduction
This project is a full-featured E-Commerce application designed to provide a seamless shopping experience. It includes functionalities like product browsing, user authentication, shopping cart management, and order processing.
## Features
- **User Authentication**: Secure login and registration system.
- **Product Management**: Browse, search, and filter products.
- **Shopping Cart**: Add, remove, and manage cart items.
- **Order Processing**: Place orders and view order history.
- **Responsive Design**: Optimized for various devices.
## Installation
To set up the project locally:
1. **Clone the repository**:
```bash
git clone https://github.com/Divith123/E-Commerce.git
cd E-Commerce
```
2. **Install dependencies**:
```bash
npm install
```
3. **Set up environment variables**:
- Create a `.env` file in the root directory.
- Add necessary environment variables (e.g., database connection strings, API keys).
4. **Run database migrations** (if applicable):
```bash
npx prisma migrate dev
```
5. **Start the development server**:
```bash
npm run dev
```
The application should now be running on `http://localhost:3000`.
## Usage
- **Register/Login**: Create a new account or log in with existing credentials.
- **Browse Products**: View the list of available products.
- **Add to Cart**: Select products and add them to your shopping cart.
- **Checkout**: Review the cart and proceed to place an order.
- **Order History**: View past orders and their statuses.
## Project Structure
```
|-- app/
|-- components/
|-- helpers/
|-- lib/
|-- prisma/
|-- public/
|-- server/
|-- utils/
|-- .eslintrc.json
|-- .gitignore
|-- LICENSE
|-- README.md
|-- package.json
|-- tailwind.config.ts
|-- tsconfig.json
|-- next.config.mjs
```
- `app/`: Main application logic.
- `components/`: Reusable UI components.
- `helpers/`: Utility functions.
- `lib/`: Shared libraries and modules.
- `prisma/`: Database schema and migrations.
- `public/`: Static assets.
- `server/`: Backend API and server-side logic.
- `utils/`: Miscellaneous utilities.
## Technologies Used
- **Next.js**: React framework for server-side rendering.
- **React**: JavaScript library for building user interfaces.
- **Tailwind CSS**: Utility-first CSS framework.
- **Prisma**: ORM for database management.
- **TypeScript**: Typed superset of JavaScript.
- **ESLint**: Linting tool for code quality.
- **PostgreSQL/MySQL**: Relational database systems.
## Contributing
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature/your-feature-name
```
3. Make your changes and commit them:
```bash
git commit -m 'Add some feature'
```
4. Push to the branch:
```bash
git push origin feature/your-feature-name
```
5. Open a pull request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.