Skip to content

An User Friendly E-Commerce Store that allows customers to browse, compare, and purchase products seamlessly. Featuring detailed product pages, secure payment processing, and personalized user accounts, it ensures an enjoyable shopping experience across all devices. **check admin repo:** https://github.com/murtazanarwar/Kartly-Admin

Notifications You must be signed in to change notification settings

murtazanarwar/Kartly-Store

Repository files navigation

🧪 Demo Credentials

for quick demo, use the following account:

Role Email Password
Customer demo@kartly.com demo123

Simply sign in at the login page with these credentials.

Project Overview

🛒 Kartly Store Platform combined with Kartly Admin Platform is a full‑featured, lightning‑fast shopping experience built with Next.js and React for indie brands, growing retailers, and developers who crave customizable, real‑time storefronts.

Whether you’re an entrepreneur launching your first online shop or a seasoned dev looking for a rock‑solid starter kit, Kartly gives you:

  • 🛒 Flexible Cart & Inventory: Quantity control, category/size/color filters, and live stock updates via Socket.IO
  • 💳 Seamless Payments: Razorpay integration out of the box
  • 📣 Marketing Ready: Billboards to spotlight promos
  • 🔒 Rock‑Solid Auth: Email signup/login/recovery/verification plus OAuth (Google, Meta)
  • 📐 Modern Tech Stack: Next.js 15, React 18, Tailwind CSS, Zustand, React Hook Form & Zod, Cloudinary, and more

Kartly is perfect for:

  • 🛍️ Small‑to‑mid‑sized brands who want a polished storefront
  • ⚙️ Developers seeking a plug‑and‑play e‑commerce boilerplate
  • 🚀 Teams that need real‑time features with minimal setup

Get started in minutes and delight your customers with a buttery‑smooth shopping journey!

🛠 Tech Stack

Framework & Runtime

  • 🚀 Next.js 15 (React 18) — Full‑stack React framework with built‑in SSR, SSG, and API routes

Styling & UI

  • 🎨 Tailwind CSS 3 + Plugins — Utility‑first styling, animations, and custom scrollbars
  • 🧩 Radix UI & Headless UI — Unstyled, accessible components you can theme

State & Data

  • 🌐 Zustand — Lightweight, scalable global state
  • 🔄 React Hook Form & Zod — Schema‑driven form handling & validation
  • 🔗 Axios / query-string — Easy API calls and query management

Real‑Time & Media

  • Socket.IO (client & server) — Live stock updates and notifications
  • 📸 next-cloudinary — Seamless image uploads & transformations

Authentication & Payments

  • 🔒 Custom Auth (Email/Password + Email Verification and Password Recovery )
  • 🌐 OAuth (Google, Facebook in progress)
  • 💳 Razorpay Checkout — Indian market payment integration

Dev & Deployment

  • 🛠️ ESLint & TypeScript — Static typing and linting for rock‑solid code
  • ⚙️ PostCSS & Tailwind CSS CLI — Build‑time CSS processing
  • ☁️ Vercel (or your preferred host) — One‑click deployment, auto‑scaling
  • 🎁 React Hot Toast — User‑friendly in‑app notifications
  • 🔍 Lucide React & React Icons — Feather‑style and custom iconography

Demo

Here are quick walkthroughs of various features of the Kartly Admin Portal.

🔐 Authentication and Order Placement

🔐 live stock updates

🔐 Product Filtering

Environment Variables

To run this project, you will need to add the following environment variables to your .env file:

# Backend API base URL (replace {storeId} with actual store identifier at runtime)
NEXT_PUBLIC_API_URL=http://your-admin.com/api/{storeId}

# Cloudinary Cloud Name for image uploads
NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name_here

# URL for your real-time socket server
NEXT_PUBLIC_SOCKET_SERVICE_URL=https://your-socket-server.com

Run Locally

Clone the project

  git clone https://github.com/murtazanarwar/E-Commerce-Store

Go to the project directory

  cd my-project

Install dependencies

  npm install

Build the Next.js application

  npm run build

Start the server

  npm run start

License

License: MIT

Badges

Version
Build Status
Coverage Status
Dependencies
License: GPL v3
License: AGPL
PRs Welcome

About

An User Friendly E-Commerce Store that allows customers to browse, compare, and purchase products seamlessly. Featuring detailed product pages, secure payment processing, and personalized user accounts, it ensures an enjoyable shopping experience across all devices. **check admin repo:** https://github.com/murtazanarwar/Kartly-Admin

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published