diff --git a/app/api/v1/public/vendors/pages.py b/app/api/v1/public/vendors/pages.py
new file mode 100644
index 00000000..d171590a
--- /dev/null
+++ b/app/api/v1/public/vendors/pages.py
@@ -0,0 +1,399 @@
+# app/api/v1/shop/pages.py
+"""
+Shop/Customer HTML page routes using Jinja2 templates.
+
+These routes serve the public-facing shop interface for customers.
+Authentication required only for account pages.
+
+Routes:
+- GET /shop/                      → Shop homepage / product catalog
+- GET /shop/products              → Product catalog
+- GET /shop/products/{id}         → Product detail page
+- GET /shop/categories/{slug}     → Category products
+- GET /shop/cart                  → Shopping cart
+- GET /shop/checkout              → Checkout process
+- GET /shop/account/register      → Customer registration
+- GET /shop/account/login         → Customer login
+- GET /shop/account/dashboard     → Customer dashboard (auth required)
+- GET /shop/account/orders        → Order history (auth required)
+- GET /shop/account/orders/{id}   → Order detail (auth required)
+- GET /shop/account/profile       → Customer profile (auth required)
+- GET /shop/account/addresses     → Address management (auth required)
+"""
+
+from fastapi import APIRouter, Request, Depends, Path
+from fastapi.responses import HTMLResponse, RedirectResponse
+from fastapi.templating import Jinja2Templates
+from sqlalchemy.orm import Session
+
+from app.api.deps import get_current_customer_user, get_db
+from models.database.user import User
+
+router = APIRouter()
+templates = Jinja2Templates(directory="app/templates")
+
+
+# ============================================================================
+# PUBLIC SHOP ROUTES (No Authentication Required)
+# ============================================================================
+
+@router.get("/shop/", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/shop/products", response_class=HTMLResponse, include_in_schema=False)
+async def shop_products_page(request: Request):
+    """
+    Render shop homepage / product catalog.
+    Shows featured products and categories.
+    """
+    return templates.TemplateResponse(
+        "shop/products.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/products/{product_id}", response_class=HTMLResponse, include_in_schema=False)
+async def shop_product_detail_page(
+    request: Request,
+    product_id: int = Path(..., description="Product ID")
+):
+    """
+    Render product detail page.
+    Shows product information, images, reviews, and buy options.
+    """
+    return templates.TemplateResponse(
+        "shop/product.html",
+        {
+            "request": request,
+            "product_id": product_id,
+        }
+    )
+
+
+@router.get("/shop/categories/{category_slug}", response_class=HTMLResponse, include_in_schema=False)
+async def shop_category_page(
+    request: Request,
+    category_slug: str = Path(..., description="Category slug")
+):
+    """
+    Render category products page.
+    Shows all products in a specific category.
+    """
+    return templates.TemplateResponse(
+        "shop/category.html",
+        {
+            "request": request,
+            "category_slug": category_slug,
+        }
+    )
+
+
+@router.get("/shop/cart", response_class=HTMLResponse, include_in_schema=False)
+async def shop_cart_page(request: Request):
+    """
+    Render shopping cart page.
+    Shows cart items and allows quantity updates.
+    """
+    return templates.TemplateResponse(
+        "shop/cart.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/checkout", response_class=HTMLResponse, include_in_schema=False)
+async def shop_checkout_page(request: Request):
+    """
+    Render checkout page.
+    Handles shipping, payment, and order confirmation.
+    """
+    return templates.TemplateResponse(
+        "shop/checkout.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/search", response_class=HTMLResponse, include_in_schema=False)
+async def shop_search_page(request: Request):
+    """
+    Render search results page.
+    Shows products matching search query.
+    """
+    return templates.TemplateResponse(
+        "shop/search.html",
+        {
+            "request": request,
+        }
+    )
+
+
+# ============================================================================
+# CUSTOMER ACCOUNT - PUBLIC ROUTES (No Authentication)
+# ============================================================================
+
+@router.get("/shop/account/register", response_class=HTMLResponse, include_in_schema=False)
+async def shop_register_page(request: Request):
+    """
+    Render customer registration page.
+    No authentication required.
+    """
+    return templates.TemplateResponse(
+        "shop/account/register.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/account/login", response_class=HTMLResponse, include_in_schema=False)
+async def shop_login_page(request: Request):
+    """
+    Render customer login page.
+    No authentication required.
+    """
+    return templates.TemplateResponse(
+        "shop/account/login.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/account/forgot-password", response_class=HTMLResponse, include_in_schema=False)
+async def shop_forgot_password_page(request: Request):
+    """
+    Render forgot password page.
+    Allows customers to reset their password.
+    """
+    return templates.TemplateResponse(
+        "shop/account/forgot-password.html",
+        {
+            "request": request,
+        }
+    )
+
+
+# ============================================================================
+# CUSTOMER ACCOUNT - AUTHENTICATED ROUTES
+# ============================================================================
+
+@router.get("/shop/account/", response_class=RedirectResponse, include_in_schema=False)
+async def shop_account_root():
+    """
+    Redirect /shop/account/ to dashboard.
+    """
+    return RedirectResponse(url="/shop/account/dashboard", status_code=302)
+
+
+@router.get("/shop/account/dashboard", response_class=HTMLResponse, include_in_schema=False)
+async def shop_account_dashboard_page(
+    request: Request,
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer account dashboard.
+    Shows account overview, recent orders, and quick links.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/dashboard.html",
+        {
+            "request": request,
+            "user": current_user,
+        }
+    )
+
+
+@router.get("/shop/account/orders", response_class=HTMLResponse, include_in_schema=False)
+async def shop_orders_page(
+    request: Request,
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer orders history page.
+    Shows all past and current orders.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/orders.html",
+        {
+            "request": request,
+            "user": current_user,
+        }
+    )
+
+
+@router.get("/shop/account/orders/{order_id}", response_class=HTMLResponse, include_in_schema=False)
+async def shop_order_detail_page(
+    request: Request,
+    order_id: int = Path(..., description="Order ID"),
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer order detail page.
+    Shows detailed order information and tracking.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/order-detail.html",
+        {
+            "request": request,
+            "user": current_user,
+            "order_id": order_id,
+        }
+    )
+
+
+@router.get("/shop/account/profile", response_class=HTMLResponse, include_in_schema=False)
+async def shop_profile_page(
+    request: Request,
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer profile page.
+    Edit personal information and preferences.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/profile.html",
+        {
+            "request": request,
+            "user": current_user,
+        }
+    )
+
+
+@router.get("/shop/account/addresses", response_class=HTMLResponse, include_in_schema=False)
+async def shop_addresses_page(
+    request: Request,
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer addresses management page.
+    Manage shipping and billing addresses.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/addresses.html",
+        {
+            "request": request,
+            "user": current_user,
+        }
+    )
+
+
+@router.get("/shop/account/wishlist", response_class=HTMLResponse, include_in_schema=False)
+async def shop_wishlist_page(
+    request: Request,
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer wishlist page.
+    View and manage saved products.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/wishlist.html",
+        {
+            "request": request,
+            "user": current_user,
+        }
+    )
+
+
+@router.get("/shop/account/settings", response_class=HTMLResponse, include_in_schema=False)
+async def shop_settings_page(
+    request: Request,
+    current_user: User = Depends(get_current_customer_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customer account settings page.
+    Configure notifications, privacy, and preferences.
+    Requires customer authentication.
+    """
+    return templates.TemplateResponse(
+        "shop/account/settings.html",
+        {
+            "request": request,
+            "user": current_user,
+        }
+    )
+
+
+# ============================================================================
+# STATIC CONTENT PAGES
+# ============================================================================
+
+@router.get("/shop/about", response_class=HTMLResponse, include_in_schema=False)
+async def shop_about_page(request: Request):
+    """
+    Render about us page.
+    """
+    return templates.TemplateResponse(
+        "shop/about.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/contact", response_class=HTMLResponse, include_in_schema=False)
+async def shop_contact_page(request: Request):
+    """
+    Render contact us page.
+    """
+    return templates.TemplateResponse(
+        "shop/contact.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/faq", response_class=HTMLResponse, include_in_schema=False)
+async def shop_faq_page(request: Request):
+    """
+    Render FAQ page.
+    """
+    return templates.TemplateResponse(
+        "shop/faq.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/privacy", response_class=HTMLResponse, include_in_schema=False)
+async def shop_privacy_page(request: Request):
+    """
+    Render privacy policy page.
+    """
+    return templates.TemplateResponse(
+        "shop/privacy.html",
+        {
+            "request": request,
+        }
+    )
+
+
+@router.get("/shop/terms", response_class=HTMLResponse, include_in_schema=False)
+async def shop_terms_page(request: Request):
+    """
+    Render terms and conditions page.
+    """
+    return templates.TemplateResponse(
+        "shop/terms.html",
+        {
+            "request": request,
+        }
+    )
diff --git a/app/api/v1/vendor/pages.py b/app/api/v1/vendor/pages.py
new file mode 100644
index 00000000..d38986ee
--- /dev/null
+++ b/app/api/v1/vendor/pages.py
@@ -0,0 +1,317 @@
+# app/api/v1/vendor/pages.py
+"""
+Vendor HTML page routes using Jinja2 templates.
+
+These routes serve HTML pages for vendor-facing interfaces.
+Supports both path-based (/vendor/{vendor_code}/) and subdomain-based access.
+
+All routes except /login require vendor authentication.
+Authentication failures redirect to /vendor/{vendor_code}/login.
+
+Routes:
+- GET /vendor/{vendor_code}/             → Redirect to login or dashboard
+- GET /vendor/{vendor_code}/login        → Vendor login page
+- GET /vendor/{vendor_code}/dashboard    → Vendor dashboard
+- GET /vendor/{vendor_code}/products     → Product management
+- GET /vendor/{vendor_code}/orders       → Order management
+- GET /vendor/{vendor_code}/customers    → Customer management
+- GET /vendor/{vendor_code}/inventory    → Inventory management
+- GET /vendor/{vendor_code}/marketplace  → Marketplace imports
+- GET /vendor/{vendor_code}/team         → Team management
+- GET /vendor/{vendor_code}/settings     → Vendor settings
+"""
+
+from fastapi import APIRouter, Request, Depends, Path
+from fastapi.responses import HTMLResponse, RedirectResponse
+from fastapi.templating import Jinja2Templates
+from sqlalchemy.orm import Session
+
+from app.api.deps import get_current_vendor_user, get_db
+from models.database.user import User
+
+router = APIRouter()
+templates = Jinja2Templates(directory="app/templates")
+
+
+# ============================================================================
+# PUBLIC ROUTES (No Authentication Required)
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/", response_class=RedirectResponse, include_in_schema=False)
+async def vendor_root(vendor_code: str = Path(..., description="Vendor code")):
+    """
+    Redirect /vendor/{code}/ to login page.
+    """
+    return RedirectResponse(url=f"/vendor/{vendor_code}/login", status_code=302)
+
+
+@router.get("/vendor/{vendor_code}/login", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_login_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code")
+):
+    """
+    Render vendor login page.
+    No authentication required.
+    """
+    return templates.TemplateResponse(
+        "vendor/login.html",
+        {
+            "request": request,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# AUTHENTICATED ROUTES (Vendor Users Only)
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/dashboard", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_dashboard_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render vendor dashboard.
+    Shows sales metrics, recent orders, and quick actions.
+    """
+    return templates.TemplateResponse(
+        "vendor/dashboard.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# PRODUCT MANAGEMENT
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/products", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/vendor/{vendor_code}/admin/products", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_products_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render products management page.
+    List, create, edit, and manage products.
+    """
+    return templates.TemplateResponse(
+        "vendor/admin/products.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# ORDER MANAGEMENT
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/orders", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/vendor/{vendor_code}/admin/orders", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_orders_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render orders management page.
+    View and process orders.
+    """
+    return templates.TemplateResponse(
+        "vendor/admin/orders.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# CUSTOMER MANAGEMENT
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/customers", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/vendor/{vendor_code}/admin/customers", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_customers_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render customers management page.
+    View and manage customer relationships.
+    """
+    return templates.TemplateResponse(
+        "vendor/admin/customers.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# INVENTORY MANAGEMENT
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/inventory", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/vendor/{vendor_code}/admin/inventory", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_inventory_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render inventory management page.
+    Track and manage stock levels.
+    """
+    return templates.TemplateResponse(
+        "vendor/admin/inventory.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# MARKETPLACE IMPORTS
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/marketplace", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/vendor/{vendor_code}/admin/marketplace", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_marketplace_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render marketplace import page.
+    Import products from external marketplaces.
+    """
+    return templates.TemplateResponse(
+        "vendor/admin/marketplace.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# TEAM MANAGEMENT
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/team", response_class=HTMLResponse, include_in_schema=False)
+@router.get("/vendor/{vendor_code}/admin/team", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_team_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render team management page.
+    Manage vendor staff and permissions.
+    """
+    return templates.TemplateResponse(
+        "vendor/admin/team.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# SETTINGS
+# ============================================================================
+
+@router.get("/vendor/{vendor_code}/settings", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_settings_page(
+    request: Request,
+    vendor_code: str = Path(..., description="Vendor code"),
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Render vendor settings page.
+    Configure vendor preferences and integrations.
+    """
+    return templates.TemplateResponse(
+        "vendor/settings.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": vendor_code,
+        }
+    )
+
+
+# ============================================================================
+# FALLBACK ROUTES (Query Parameter Based - For backward compatibility)
+# ============================================================================
+
+@router.get("/vendor/", response_class=RedirectResponse, include_in_schema=False)
+async def vendor_fallback_root():
+    """
+    Redirect to main site if no vendor code in path.
+    User should use /vendor/{code}/ format.
+    """
+    return RedirectResponse(url="/", status_code=302)
+
+
+@router.get("/vendor/login", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_fallback_login(request: Request):
+    """
+    Fallback vendor login page (query parameter based).
+    For backward compatibility - new code should use /vendor/{code}/login
+    """
+    return templates.TemplateResponse(
+        "vendor/login.html",
+        {
+            "request": request,
+            "vendor_code": None,  # Will be retrieved from query param or localStorage
+        }
+    )
+
+
+@router.get("/vendor/dashboard", response_class=HTMLResponse, include_in_schema=False)
+async def vendor_fallback_dashboard(
+    request: Request,
+    current_user: User = Depends(get_current_vendor_user),
+    db: Session = Depends(get_db)
+):
+    """
+    Fallback vendor dashboard (query parameter based).
+    For backward compatibility - new code should use /vendor/{code}/dashboard
+    """
+    return templates.TemplateResponse(
+        "vendor/dashboard.html",
+        {
+            "request": request,
+            "user": current_user,
+            "vendor_code": None,  # Will be retrieved from token or localStorage
+        }
+    )