Installation Guide

After purchasing Nextall – React Multivendor Ecommerce Script, you will receive a .zip file.
Inside the zip, you will find two folders:

nextall-be → Backend (APIs, authentication, payments, vendor & admin logic)
nextall-fe → Frontend (UI, user experience, vendor dashboard, admin panel)

Backend Setup (nextall-be)

The backend is built with Node.js, Express, and MongoDB. It manages all APIs, authentication, vendor commissions, orders, and payments.

The Nextall backend (nextall-be) is developed with the latest technologies:

Node.js
Express
JavaScript
MongoDB
Mongoose

Prerequisites

Before you start, make sure you have the following installed:

Node.js (v18 or above recommended)
npm (comes with Node.js) or yarn/pnpm
A running instance of the backend (nextall-be)

Steps to Run Backend

Open the main project folder in VSCODE
Navigate to the nextall-be folder:
```
cd nextall-be
```
Install the dependencies
```
npm i
```
Update the .env.example file into .env
```
cp .env.example .env
```

Update the .env file with your own values (example with fake values):


# Server Configuration
NODE_ENV=development
PORT=8080
API_VERSION=v1
 
# Admin account
ADMIN_EMAIL=admin@example.com
PASSWORD=ChangeMe123!
 
# SMTP Configuration
SMTP_ACTIVE=true
SMTP_HOST=smtp.example.com
SMTP_PORT=465
SMTP_SECURE=true
SMTP_USER=smtp-user@example.com
SMTP_PASSWORD=app-password-example
 
# PayPal Configuration
PAYPAL_CLIENT_ID=paypal_client_id_example_123456
PAYPAL_ACTIVE=true
# live or sandbox
PAYPAL_MODE=sandbox
 
# Stripe Configuration
STRIPE_PUBLISHABLE_KEY=pk_test_example_publishable_key
STRIPE_SECRET_KEY=sk_test_example_secret_key
STRIPE_ACTIVE=true
# live or sandbox
STRIPE_MODE=sandbox
 
# Cloudinary Configuration
CLOUDINARY_CLOUD_NAME=demo-cloud-name
CLOUDINARY_API_KEY=123456789012345
CLOUDINARY_API_SECRET=cloudinary_secret_example
CLOUDINARY_PRESET=uploads-preset-example
 
# Shipping Fee in Base Currency Configuration
SHIPPING_FEE=10.00
# Admin commission percentage for each order
ADMIN_COMMISSION_PERCENTAGE=10
 
# Google Tags Manager Configuration
GTM_ID=GTM-XXXXXXX
GA_ID=UA-000000-2
 
# MongoDB Database
MONGODB_URI=mongodb+srv://db_user:db_password@cluster0.example.mongodb.net/
DB_NAME=nextall_demo
 
# JWT Configuration
JWT_SECRET=replace_with_a_long_random_secret
JWT_EXPIRES_IN=7d
 
# Email Configuration (Nodemailer)
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_SECURE=false
EMAIL_USER=mailer@example.com
EMAIL_PASSWORD=email_password_example
EMAIL_FROM="Nextall App <noreply@example.com>"
 
# Cache Configuration
CACHE_DURATION=5 minutes
 
# Debug
DEBUG=app:*
 
# Arcjet Security
# Get your key from https://app.arcjet.com
ARCJET_KEY=ajkey_example_abcdefghijklmnopqrstuvwxyz
# Arcjet environment (development | production)
ARCJET_ENV=development
# Rule mode (LIVE | DRY_RUN). Defaults to DRY_RUN in non-production.
ARCJET_MODE=DRY_RUN
# Token bucket rate limiting
ARCJET_RATE_REFILL=5
ARCJET_RATE_INTERVAL=10
ARCJET_RATE_CAPACITY=10
ARCJET_RATE_REQUESTED=1

Run the backend server:
```
npm run dev
```
✅ Success
Your backend server is running successfully on http://localhost:5000

Frontend Installation Guide

The Nextall Frontend (nextall-fe) is developed with the latest technologies:

Next.js 15 (App Router)
React 19 (JavaScript)
Material UI v7
Redux Toolkit
Formik + Yup
Embla Carousel
React ApexCharts
Prettier + ESLint

This frontend application is responsible for rendering all the UI elements, user experience, and interacting with the backend APIs. The backend (nextall-be) handles the database, authentication, business logic, and API responses, while the frontend (nextall-fe) consumes those APIs and provides a rich and modern eCommerce experience.

Navigate to the nextall-fe folder:
```
cd nextall-fe
```
Install the dependencies
```
npm i
```
Update the .env.development.example file into .env.development, and .env.production.example file into .env.production
```
cp .env.development.example .env.development && cp .env.production.example .env.production
```
Update the .env file with your own values:
```
NEXT_PUBLIC_API_URL=http://localhost:5000
```
Run the server:
```
npm run dev
```
✅ Success
Your frontend server is successfully running on http://localhost:3000