🛒 NextShop — The Complete Next.js eCommerce Solution

Launch a professional online store in minutes. NextShop is a full-stack, production-ready eCommerce platform built with cutting-edge technology.

⚡ TECH STACK
- Next.js 16 (App Router)
- React 19
- Prisma 7 ORM
- Tailwind CSS 4
- NextAuth v5 (Google + Email login)
- PostgreSQL

🛍️ STOREFRONT FEATURES
✓ Modern responsive design
✓ Product catalog with variants (color, size)
✓ Nested categories & subcategories
✓ Advanced search & filtering
✓ Shopping cart & wishlist
✓ Product reviews with images & ratings
✓ Coupon / discount system
✓ Multi-currency support
✓ SEO optimized (sitemap, meta tags)
✓ WhatsApp float button

💳 PAYMENTS & CHECKOUT
✓ Stripe integration (international)
✓ Cash on Delivery (COD)
✓ Bank transfer support
✓ Tax & shipping calculation
✓ Order tracking

🔧 ADMIN PANEL
✓ Product & inventory management
✓ Order management with status updates
✓ Coupon & banner management
✓ Sales analytics dashboard
✓ Reviews moderation
✓ Courier load-sheet generation

👑 SUPER ADMIN
✓ Full revenue analytics
✓ User role management
✓ Admin activity logs

📦 WHAT YOU GET
✓ Full unencrypted source code
✓ Setup documentation
✓ Demo data / seed file
✓ Free updates
✓ Email support

👥 User Roles / Panels (3-Tier Access System)
- Super Admin Panel – Full control over entire system, admin management, global settings, permissions control
- Admin Panel – Store/product management, order management, reports, staff-level access
- User (Customer) Panel – Registration/login, order history, profile management, wishlist, cart

🛒 Core E-Commerce Features
- Product listing with categories & sub-categories
- Product search & filters (price, category, brand, etc.)
- Product detail page with image gallery
- Shopping cart system
- Wishlist / Favorites
- Multiple payment gateway support
- Cash on Delivery (COD) option
- Order tracking system
- Invoice generation
- Coupon / Discount code system
- Stock/inventory management
- Product reviews & ratings
- Related products / recommendations
- Multi-image product upload
- Responsive design (mobile/tablet/desktop friendly)

📦 Courier / Shipping Integration
- Integrated courier system for order shipment & tracking
- Auto order booking with courier service
- Shipment status updates
- Delivery charges management (zone/weight based)

📱 Marketing & Social Integration
- Facebook Page integration
- Instagram integration
- Facebook Pixel integration (for ad tracking & conversion optimization)
- Social login option (optional if added)

🛠️ Admin-Side Management Features
- Dashboard with sales analytics/reports
- Order management (pending, processing, completed, cancelled)
- Customer management
- Product & category management (CRUD)
- Banner/slider management
- SEO settings (meta title, description, slug)
- Role-based access control

🔐 Security Features
- Secure login authentication
- Role-based permissions
- Data validation & sanitization

⚙️ Technical Highlights
- Clean & customized template/theme
- Optimized code structure
- Easy to configure/install
- Well-documented

The technical requirements are mentioned in .env

DATABASE_URL=your PostgreSQL connection string (e.g. from Neon, Supabase, Railway, or Prisma Postgres)

NEXTAUTH_SECRET=random secret string for NextAuth
AUTH_SECRET=random 32-character secret code
NEXTAUTH_URL=your domain URL

CLOUDINARY_CLOUD_NAME=create a Cloudinary account and add your cloud name here (used for storing product images)
CLOUDINARY_API_KEY=get this from your Cloudinary dashboard
CLOUDINARY_API_SECRET=get this from your Cloudinary dashboard

SMTP_HOST=get this from your domain's email hosting panel
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your email username
SMTP_PASS=the password you set when creating the mailbox
FROM_EMAIL=sender email address
STORE_NAME=your store name

FB_PAGE_ID=get this from Facebook Page settings
FB_PAGE_ACCESS_TOKEN=get this from Facebook Developer settings
IG_ACCOUNT_ID=get this from your Instagram Business account
NEXT_PUBLIC_SITE_URL=your domain URL

POSTEX_TOKEN=PostEx courier system is included — get your token from the PostEx portal
POSTEX_PICKUP_ADDRESS_CODE=your address code from the PostEx portal
POSTEX_PICKUP_ADDRESS=your pickup address as registered in the PostEx portal
POSTEX_WEBHOOK_SECRET=from the PostEx portal (used for receiving order status updates)
NEXT_PUBLIC_FB_PIXEL_ID=your Facebook Pixel ID

Installation Instructions

1. Prerequisites (install these first):
- Node.js v20.x or higher (LTS recommended)
- npm (comes with Node) or yarn
- PostgreSQL database (local or cloud — Neon, Supabase, Railway, or your own VPS)
- Git (optional, for cloning/extracting the code)

2. Steps to run locally:

# 1. Navigate to the project folder
cd project-folder

# 2. Install dependencies
npm install

# 3. Create a .env file in the root folder and add the variables listed in the Requirements section above.

# 4. Set up Prisma - push/migrate the database schema
npx prisma generate
npx prisma migrate deploy
# or for development:
npx prisma migrate dev

# 5. Start the development server
npm run dev

# 6. Open in browser
http://localhost:3000

3. Production Build:
npm run build
npm run start

4. Required Third-Party Accounts:
- PostgreSQL database (Neon/Supabase/Railway or self-hosted)
- Cloudinary account (for image uploads)
- SMTP mailbox or Resend account (for transactional emails)
- Facebook Developer account (for Pixel/Facebook/Instagram integration)
- PostEx courier account (for shipment tracking)