https://github.com/antaripdebgupta/customer-segmentation
Customer Segmentation Web App (Final-Year MVP)
https://github.com/antaripdebgupta/customer-segmentation
appwrite clerk-auth nextjs reactjs recharts shadcn-ui
Last synced: about 2 months ago
JSON representation
Customer Segmentation Web App (Final-Year MVP)
- Host: GitHub
- URL: https://github.com/antaripdebgupta/customer-segmentation
- Owner: antaripdebgupta
- Created: 2025-09-09T17:50:28.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-12-22T11:28:11.000Z (6 months ago)
- Last Synced: 2026-04-30T11:34:10.629Z (about 2 months ago)
- Topics: appwrite, clerk-auth, nextjs, reactjs, recharts, shadcn-ui
- Language: JavaScript
- Homepage: https://customer-segmentation-theta.vercel.app
- Size: 309 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ClusterCart – Customer Segmentation Web App
ClusterCart is a modern, minimalistic Customer Segmentation Web App built as a Final-Year Project.
It allows users to upload customer datasets, explore clustering visualizations, and view dashboards & insights — all in one place.
---
## 📝 Overview
ClusterCart is a **Customer Segmentation Web Application** designed to help businesses better understand their customers.
With an intuitive UI and modern tech stack, users can:
- **Upload CSV datasets** and store them securely.
- **Visualize customer clusters** (demo version).
- **Explore dashboards and insights** to make data-driven decisions.
---
## 🛠 Tech Stack
| Technology | Purpose |
|---------------|---------|
| **[Next.js (App Router)](https://nextjs.org/)** | Frontend framework for building a fast, scalable web app |
| **[Appwrite](https://appwrite.io/)** | Backend-as-a-Service for database and storage |
| **[Clerk](https://clerk.com/)** | Authentication (Email + Google Sign-in) |
| **[shadcn/ui](https://ui.shadcn.com/)** | UI components for a clean, accessible design |
| **[Tailwind CSS](https://tailwindcss.com/)** | Utility-first CSS for styling |
| **[Recharts](https://recharts.org/en-US/)** | Data visualization library for cluster graphs |
---
## ✨ Features
- **Authentication**
- Email + Google Sign-in (fully working)
- **Upload Page** (`/upload`)
- Upload CSV file
- Save data to **Appwrite DB**
- View & delete saved datasets
- **Clusters Page** (`/clusters`)
- Placeholder visualization with **Recharts** (Demo)
- **Dashboard Page** (`/dashboard`)
- Sample analytics dashboard (Demo)
- **Insights Page** (`/insights`)
- Recommendations and customer insights(Demo)
## ⚙️ Installation & Setup
Follow these steps to run ClusterCart locally:
```bash
# 1️⃣ Clone the repository
git clone https://github.com/antaripdebgupta/customer-segmentation.git
cd customer-segmentation
# 2️⃣ Install dependencies
npm install
# 3️⃣ Configure environment variables
# Create a `.env.local` file in the root and add:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=public-key
CLERK_SECRET_KEY=secret_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/
APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
APPWRITE_PROJECT_ID=project_id
APPWRITE_API_KEY=api_key
APPWRITE_DATABASE_ID=database_id
APPWRITE_COLLECTION_ID=collection_id
APPWRITE_BUCKET_ID=bucket_id
# 4️⃣ Run locally
npm run dev