Sellzy

The Ultimate Fullstack Ecommerce Platform

Welcome to the official documentation. Sellzy is a powerful modern storefront natively engineered with strictly typed Next.js, immersive animations, and secure Stripe infrastructure.

Overview

Sellzy provides everything you need to launch a professional online store, including a modern storefront, powerful admin dashboard, secure payment integration, robust product management, and a scalable monorepo architecture.

Whether you want to build an automated online shop, multi-vendor marketplace, or startup ecommerce platform, Sellzy rapidly accelerates your time to market with production-ready code.

Perfect For:

Online Stores Ecommerce Startups Marketplace Digital Products Multi-Vendor Stores

Why Choose Sellzy?

Modern Fullstack Architecture

Production Ready Clean Code

Bank-Level Stripe Security

Deeply Scalable Codebase

Features

🚀 Key Features

Modern Tech Stack

Next.js Engine: High-performance App Router
React.js: Isomorphic component-driven Frontend
Node.js & Express: Dedicated Backend API
Database: Native MongoDB integration
Turborepo: Fully scalable strict workspace

Powerful Ecommerce System

Product Engine: Full SKU & variants handling
Categories: Deep hierarchical routing structures
Cart State: Global Zustand synchronized carts
Orders: Client dashboard and deep tracking
Multi-Image: Free-tier optimized ImageKit delivery

Secure Payment Integration

Stripe Connected: Official Stripe Elements checkout
Webhooks: Automated status tracking on success
Security: Complete Bank-level vault infrastructure
Notifications: Instant email receipts dispatched

Advanced Admin Dashboard

Isolated Portal: Independent Vite React application
CRUD Flow: Comprehensive model management
Order Metrics: Direct live sales visual analytics
Protected Auth: JWT Firebase hybrid session control

Professional Storefront

Immersive UI: Hand-crafted premium design layouts
Responsive View: Complete mobile-first DOM routing
Speed: SSG/ISR caching for sub-second delivery
SEO Ready: Native metadata and OpenGraph hooks

Multi-User System

Client Dash: Persistent user profile management
Registration: Seamless email/password secure setups
History: Full chronological order fulfillment memory
Address Book: Stored default shipping coordinations

Developer Friendly Architecture

Clean Code Structure Easy Customization Well Organized Components Reusable UI Components API Ready Architecture

🛒 Ecommerce Features

Product Listing Product Details Page Shopping Cart Checkout Page Order Management Customer Accounts Admin Dashboard Payment Integration

⚡ Performance & Optimization

Sellzy is built with performance in mind to ensure blazing fast user experiences.

Server Side Rendering SEO Optimized Fast Loading Pages Optimized API Calls Modern React Architecture

📱 Fully Responsive Design

Sellzy works perfectly across all devices. Your customers will enjoy a seamless shopping experience everywhere.

Desktop

Laptop

Tablet

Mobile

Setup & Installation

🧰 Tech Stack

Frontend Store (Web)	Next.js (16.1), React (19.2), Tailwind CSS (v4), Zustand, Firebase Auth, Framer Motion, Radix UI
Admin Dashboard	Vite, React (19.2), React Hook Form, Recharts, Dnd-kit, Tailwind CSS
Backend API	Node.js, Express.js, Stripe Payments, JWT Auth, ImageKit, Nodemailer, Bcrypt
Database & Media	MongoDB (Mongoose), ImageKit (Cloud Image Storage)

📂 What You Get

Upon downloading Sellzy, your bundle securely includes:

Complete Turborepo Source Code
Next.js Frontend Storefront
Vite + React Admin Dashboard
Node.js + Express API Backend
Comprehensive Documentation

🧑‍💻 System Requirements

To seamlessly run the fullstack environment locally:

Node.js (v18.0.0 or higher)
pnpm (Strictly required for Turborepo)
MongoDB (Cloud Atlas or Local)
ImageKit Account (Free Tier)
Stripe Account (For Payments)
Firebase Account (For Auth flows)

📦 Turborepo Architecture

Sellzy is expertly packaged using a highly optimized Turborepo architecture to perfectly guarantee isolated environments, cached builds, and rapid CI/CD build pipelines natively.

sellzy-ecommerce/architecture

                        sellzy-ecommerce/

                        ├── apps/

                        │ ├── admin/
                        # Vite + React Admin Dashboard

                        │ │ ├── src/

                        │ │ │ ├── components/
                        # Reusable admin UI blocks

                        │ │ │ ├── pages/
                        # Dashboard routing & views

                        │ │ │ └── store/
                        # Zustand state management

                        │ │ └── vite.config.ts

                        │ ├── api/
                        # Node.js Express Backend API

                        │ │ ├── config/
                        # Env & database configurations

                        │ │ ├── controllers/
                        # Application business logic

                        │ │ ├── models/
                        # Mongoose schema definitions

                        │ │ ├── routes/
                        # Express API endpoints

                        │ │ └── server.ts
                        # Node.js entry point

                        │ └── web/
                        # Next.js Frontend Storefront

                        │ ├── src/

                        │ │ ├── app/
                        # Next.js App Router pages

                        │ │ ├── components/
                        # Storefront React components

                        │ │ └── store/
                        # Zustand ecommerce stores

                        │ └── next.config.ts

                        ├── packages/
                        # Centralized Shared UI & Settings Plugins

                        ├── package.json
                        # Root monorepo workspace dependencies

                        ├── pnpm-workspace.yaml
                        # Native pnpm orchestration mappings

                        └── turbo.json
                        # Turborepo task runner & caching configuration
                      

⚙️ Project Setup Guidelines

Follow these stringently outlined step-by-step guidelines to deploy your Sellzy platform locally and into production.

Step 1: Sync to Version Control (GitHub)

Anyone who purchases the product should first initialize a git repository and sync the source code to GitHub. This ensures safety and enables automated Continuous Integration (CI/CD) pipelines.

bash

git init
git add .
git commit -m "Initial Sellzy Commit"
git branch -M main
git remote add origin https://github.com/yourusername/your-repo.git
git push -u origin main

Step 2: Environment Configuration (.env)

After syncing, you must fetch and configure all `.env` credentials for each individual app before starting.

apps/api/.env

# Get your MongoDB URI from https://cloud.mongodb.com
MONGO_URI="mongodb+srv://<user>:<password>@cluster.mongodb.net/sellzy"

JWT_SECRET="your_secure_jwt_secret"
PORT=8000
NODE_ENV=development

SERVER_URL="http://localhost:8000"
CLIENT_URL="http://localhost:3000"
ADMIN_URL="http://localhost:5173"

# Payment processing - Get keys from https://dashboard.stripe.com/apikeys
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."

# Email dispatch (Use Google App Passwords if using Gmail)
SMTP_HOST="smtp.gmail.com"
SMTP_PORT=587
SMTP_USER="your-email@gmail.com"
SMTP_PASS="your_app_password"

# Image Storage - Get credentials from https://imagekit.io/dashboard/developer/api-keys
DEFAULT_UPLOAD_PROVIDER=imagekit
IMAGEKIT_PUBLIC_KEY="public_..."
IMAGEKIT_PRIVATE_KEY="private_..."
IMAGEKIT_URL_ENDPOINT="https://ik.imagekit.io/..."

apps/web/.env

NEXT_PUBLIC_API_URL="http://localhost:8000"

# Firebase Client configuration for Web - Get from https://console.firebase.google.com/
NEXT_PUBLIC_FIREBASE_API_KEY="..."
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="..."
NEXT_PUBLIC_FIREBASE_PROJECT_ID="..."
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET="..."
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="..."
NEXT_PUBLIC_FIREBASE_APP_ID="..."

NEXT_PUBLIC_VAT_PERCENTAGE=0
NEXT_PUBLIC_SHIPPING_COST=0

apps/admin/.env

VITE_NEXT_PUBLIC_API_URL="http://localhost:8000"
VITE_APP_ENV=development

# Firebase Client configuration for Admin Dashboard - Get from https://console.firebase.google.com/
VITE_FIREBASE_API_KEY="..."
VITE_FIREBASE_AUTH_DOMAIN="..."
VITE_FIREBASE_PROJECT_ID="..."
VITE_FIREBASE_STORAGE_BUCKET="..."
VITE_FIREBASE_MESSAGING_SENDER_ID="..."
VITE_FIREBASE_APP_ID="..."

Step 3: Install & Start Development Servers

Navigate to your project directory and install all Monorepo dependencies strictly using pnpm.

bash

pnpm i
pnpm run dev

Note: pnpm run dev will automatically spin up the Web storefront, Admin dashboard, and Backend API simultaneously.

Step 4 & 5: Deployment & GitHub Automation

From local setup to production deployment, Sellzy is designed to work stringently with modern Node.js suitable platforms like Vercel, Render, or any VPS.

Automated Deployments: Because you synced the project to GitHub in Step 1, you can effortlessly link your secure GitHub repository directly to Vercel for your Frontend and Admin applications, and Render/Heroku for your Node.js API backend.
CI/CD Pipelines: Once connected, every single code change you push to the main branch on GitHub will automatically trigger Vercel to rebuild and deploy your changes without any manual intervention required.

🌐 Live Demo

Test drive Sellzy through our live preview URLs. Note: Demo credentials are included in your purchase documentation.

Frontend Demo Admin Dashboard Demo

🔧 Customization

Sellzy is built specifically for developers. Backed by our deeply structured, strictly typed Next.js and React monorepo architecture, extending the platform is exceedingly clean.

You can rapidly and easily:

Modify UI/UX Theme Styling Add Custom Business Logic Extend API Endpoints Integrate External Gateways Implement Headless Commerce

💬 Dedicated Support

If you encounter challenges with installation or extending core utilities, our dedicated ecosystem support team is ready. We prioritize our premium customer success and maintain a designated SLA resolution response time.

Official Support Coverage:

Backend Installation Walkthroughs
Platform Bug Fixes within Core Code
Advanced Documentation Queries

Need priority assistance?

Submit your query directly to our support engineers. You will receive a response within 1 business day.

Open Support Ticket