An open API service indexing awesome lists of open source software.

https://github.com/farsit-007/swiftcart

A modern Next.js e-commerce platform featuring product browsing, cart management, and secure checkout. Built with performance and user experience in mind.
https://github.com/farsit-007/swiftcart

jwt next shadcn-ui sslcommerz tailwindcss typescript

Last synced: 4 months ago
JSON representation

A modern Next.js e-commerce platform featuring product browsing, cart management, and secure checkout. Built with performance and user experience in mind.

Awesome Lists containing this project

README

          

# 🛒 SwiftCart E-Commerce Platform (Frontend)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
[![Next.js](https://img.shields.io/badge/Next.js-14.0+-black?logo=next.js)](https://nextjs.org/)
[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.3+-38B2AC?logo=tailwind-css)](https://tailwindcss.com/)

## 📌 Overview

A modern Next.js e-commerce platform featuring product browsing, cart
management, and secure checkout. Built with performance and user experience in
mind.

## 🌍 Live URLs

- **Frontend**:
[https://swift-cart-mocha.vercel.app](https://swift-cart-mocha.vercel.app)
- **Backend API**:
[https://swiftcart-server-silk.vercel.app](https://swiftcart-server-silk.vercel.app)

## 📂 Repository Links

- [Frontend](https://github.com/khaledssbd/SwiftCart)
- [Backend](https://github.com/khaledssbd/SwiftCart-APIs)

## 🛠️ Key Features

### Shopping Experience

- 🛍️ Product browsing with filters and search
- 🛒 Persistent shopping cart
- 💳 Secure checkout process

- 🔍 Advanced search functionality

### User Features

- 🔐 JWT authentication
- 📦 Order history tracking

- 📱 Fully responsive design

### Admin Features

- 📊 Sales analytics dashboard
- 📦 Product management
- 🚚 Order fulfillment
- 👥 User management

## 🏗️ Tech Stack

### Frontend

- **Framework**: Next.js 14 (App Router)
- **Styling**: Tailwind CSS
- **UI Components**: Shadcn UI
- **State Management**: Redux
- **Form Handling**: React Hook Form + Zod
- **Payment Integration**: SSLCommerz

### Backend

- **API**: RESTful services
- **Authentication**: JWT
- **Image Hosting**: Cloudinary

## 🚀 Quick Start

## 🏃‍♂️ Setup Guide (Frontend)

### Prerequisites

- Node.js ≥18.x
- npm/yarn/pnpm

### Installation

1. Clone the repository:

```bash
git clone https://github.com/khaledssbd/SwiftCart.git
cd SwiftCart

```

2. Install dependencies:

```bash
npm install

```

3. Create .env file with:

```bash
NEXT_PUBLIC_BASE_API="your_backend_url"

```

4. Run the dev server:
```bash
npm run dev
```

## 🏃‍♂️ Setup Guide (Backend)

### Prerequisites

- Node.js ≥18.x
- npm/yarn/pnpm

### Installation

1. Clone the repo:

```bash
git clone https://github.com/khaledssbd/SwiftCart-APIs.git
cd SwiftCart-APIs

```

2. Install dependencies:

```bash
npm install

```

3. Create .env file with:

```bash
NODE_ENV="development"
PORT=5000
DB_URL="mongodb_URI"

BCRYPT_SALT_ROUNDS=12
JWT_ACCESS_SECRET="" JWT_ACCESS_EXPIRES_IN=7d
JWT_REFRESH_SECRET="" JWT_REFRESH_EXPIRES_IN=1y
JWT_OTP_SECRET=""
JWT_PASS_RESET_SECRET="" JWT_PASS_RESET_EXPIRES_IN=15m

CLOUDINARY_CLOUD_NAME=""
CLOUDINARY_API_KEY=""
CLOUDINARY_API_SECRET=""

SENDER_EMAIL=""
SENDER_APP_PASS=""

STORE_NAME="teststore"
PAYMENT_API="https://sandbox.sslcommerz.com/gwprocess/v3/api.php"
VALIDATION_API="https://sandbox.sslcommerz.com/validator/api/validationserverAPI.php"
STORE_ID=""
STORE_PASSWORD=""
VALIDATION_URL=""
SUCCESS_URL=""
FAILED_URL=""
CANCEL_URL=""
```

4. Run the dev server:
```bash
npm run dev
```

## License

MIT (do whatever you want to do :smile: )