Skip to content

A feature-rich online shopping solution built with cutting-edge technologies to deliver seamless user experiences for both customers and admins.

Notifications You must be signed in to change notification settings

khaledssbd/SwiftCart

Repository files navigation

πŸ›’ SwiftCart E-Commerce Platform (Frontend)

License: MIT PRs Welcome Next.js Tailwind CSS

πŸ“Œ 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

πŸ“‚ Repository Links

πŸ› οΈ 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:

    git clone https://github.com/khaledssbd/SwiftCart.git
    cd SwiftCart
    
  2. Install dependencies:

    npm install
    
  3. Create .env file with:

    NEXT_PUBLIC_BASE_API="your_backend_url"
    
  4. Run the dev server:

    npm run dev

πŸƒβ€β™‚οΈ Setup Guide (Backend)

Prerequisites

  • Node.js β‰₯18.x
  • npm/yarn/pnpm

Installation

  1. Clone the repo:

    git clone https://github.com/khaledssbd/SwiftCart-APIs.git
    cd SwiftCart-APIs
    
  2. Install dependencies:

    npm install
    
  3. Create .env file with:

    NODE_ENV="development"
    PORT=5000
    DB_URL="mongodb_URI"
    
    BCRYPT_SALT_ROUNDS=12
    JWT_ACCESS_SECRET="<your_access_secret>" JWT_ACCESS_EXPIRES_IN=7d
    JWT_REFRESH_SECRET="<your_refresh_secret>" JWT_REFRESH_EXPIRES_IN=1y
    JWT_OTP_SECRET="<your_otp_secret>"
    JWT_PASS_RESET_SECRET="<your_pass_reset_secret>" JWT_PASS_RESET_EXPIRES_IN=15m
    
    CLOUDINARY_CLOUD_NAME="<your_cloudinary_cloud_name>"
    CLOUDINARY_API_KEY="<your_cloudinary_api_key>"
    CLOUDINARY_API_SECRET="<your_cloudinary_api_secret>"
    
    SENDER_EMAIL="<your_email>"
    SENDER_APP_PASS="<your_app_password>"
    
    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="<your_store_id>"
    STORE_PASSWORD="<your_store_password>"
    VALIDATION_URL="<your_validation_url>"
    SUCCESS_URL="<your_success_url>"
    FAILED_URL="<your_failed_url>"
    CANCEL_URL="<your_cancel_url>"
  4. Run the dev server:

    npm run dev

License

MIT (do whatever you want to do πŸ˜„ )

About

A feature-rich online shopping solution built with cutting-edge technologies to deliver seamless user experiences for both customers and admins.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5

Languages