ebazaar
🛒 Ebazaar - Modern E-Commerce Platform
A full-featured e-commerce platform built with Next.js 16, featuring a modern shopping experience with cart management, user authentication, order processing, and an admin dashboard.
📋 Table of Contents
- Features
- Tech Stack
- Prerequisites
- Getting Started
- Project Structure
- Environment Variables
- Database Schema
- Available Scripts
- Contributing
- License
- Support
✨ Features
Customer Features
- 🔐 User Authentication - Secure sign-up/sign-in with NextAuth.js
- 🛍️ Product Catalog - Browse products by category with search and filtering
- 🛒 Shopping Cart - Add/remove items, adjust quantities, apply promo codes
- 💳 Checkout - Stripe-powered payment integration
- 📦 Order Tracking - View order history and status
- ⭐ Product Reviews - Rate and review products
Admin Features
- 📊 Dashboard - Overview of sales and key metrics
- 🏪 Product Management - Create, edit, delete products
- 📁 Category Management - Organize products into categories
- 📋 Order Management - View and update order status
- 👥 User Management - View and manage user accounts
🛠 Tech Stack
| Category | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript |
| Database | SQLite with Prisma ORM |
| Authentication | NextAuth.js v5 |
| State Management | Zustand |
| Styling | Tailwind CSS v4 |
| Payments | Stripe |
| Testing | Vitest (unit) + Playwright (e2e) |
| Error Tracking | Sentry |
📌 Prerequisites
Before you begin, ensure you have the following installed:
- Node.js 18.x or later
- npm 9.x or later (or yarn/pnpm/bun)
- Git for version control
🚀 Getting Started
1. Clone the Repository
git clone https://github.com/arya-dev2005/ebazaar.git
cd ebazaar
2. Install Dependencies
npm install
# or
yarn install
# or
pnpm install
3. Configure Environment Variables
Create a .env file in the root directory:
# Database
DATABASE_URL="file:./dev.db"
# NextAuth
AUTH_SECRET="your-secret-key-here-generate-with-openssl-rand-base64-32"
AUTH_URL="http://localhost:3000"
# Stripe (get keys from https://dashboard.stripe.com)
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_PUBLISHABLE_KEY="pk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."
# Sentry (optional, get from https://sentry.io)
SENTRY_DSN=""
4. Initialize the Database
# Push schema to database
npm run db:push
# Seed with sample data (optional)
npm run db:seed
5. Start the Development Server
npm run dev
Open http://localhost:3000 in your browser.
6. Create an Admin User
After starting the server:
- Sign up a new account
- Access your database (e.g., via
npm run db:studio) - Manually update the user’s
rolefield to"ADMIN"
📁 Project Structure
ebazaar/
├── prisma/
│ ├── schema.prisma # Database schema
│ └── seed.ts # Seed data
├── src/
│ ├── actions/ # Server actions
│ │ ├── admin.ts
│ │ ├── auth.ts
│ │ ├── cart.ts
│ │ ├── category.ts
│ │ ├── order.ts
│ │ └── product.ts
│ ├── app/ # Next.js App Router
│ │ ├── (auth)/ # Auth routes (sign-in, sign-up)
│ │ ├── (shop)/ # Shop routes (products)
│ │ ├── admin/ # Admin dashboard
│ │ ├── api/ # API routes
│ │ ├── cart/ # Cart page
│ │ ├── checkout/ # Checkout flow
│ │ └── orders/ # Order history
│ ├── components/ # React components
│ │ ├── cart/
│ │ ├── home/
│ │ ├── layout/
│ │ ├── products/
│ │ └── ui/
│ ├── lib/ # Utilities and configs
│ │ ├── auth.ts
│ │ ├── prisma.ts
│ │ ├── sentry.ts
│ │ ├── stripe.ts
│ │ └── utils.ts
│ ├── services/ # Business logic
│ │ ├── cart.ts
│ │ ├── order.ts
│ │ ├── product.ts
│ │ ├── review.ts
│ │ └── user.ts
│ └── types/ # TypeScript types
├── e2e/ # Playwright tests
├── tests/ # Unit tests
└── public/ # Static assets
🗄 Database Schema
The application uses the following main models:
- User - Customer and admin accounts
- Product - Products with name, price, stock, images
- Category - Product categories
- Cart & CartItem - Shopping cart functionality
- Order & OrderItem - Order processing
- Review - Product reviews and ratings
📜 Available Scripts
| Command | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for production |
npm run start |
Start production server |
npm run lint |
Run ESLint |
npm run test |
Run unit tests |
npm run test:watch |
Run tests in watch mode |
npm run test:e2e |
Run end-to-end tests |
npm run db:push |
Push schema to database |
npm run db:seed |
Seed database with sample data |
npm run db:studio |
Open Prisma Studio |
🤝 Contributing
We welcome contributions! Please follow these steps:
1. Fork the Repository
Click the “Fork” button on GitHub.
2. Clone Your Fork
git clone https://github.com/YOUR_USERNAME/ebazaar.git
cd ebazaar
3. Create a Feature Branch
git checkout -b feature/your-feature-name
# or
git checkout -b fix/bug-description
4. Make Changes
- Follow the existing code style and conventions
- Write meaningful commit messages
- Add tests for new features
5. Commit Your Changes
git add .
git commit -m "feat: Add new feature"
6. Push to Your Fork
git push origin feature/your-feature-name
7. Create a Pull Request
- Go to the original repository
- Click “New Pull Request”
- Select your branch and submit
- Fill in the PR template with:
- Description of changes
- Related issue number (if applicable)
- Screenshots (for UI changes)
Code Style Guidelines
- Use TypeScript for all new code
- Follow ESLint configuration
- Use meaningful variable and function names
- Add comments for complex logic
- Keep components small and focused
Commit Message Format
We follow Conventional Commits:
<type>(<scope>): <description>
[optional body]
[optional footer]
Types:
feat- New featurefix- Bug fixdocs- Documentationstyle- Formattingrefactor- Code restructuringtest- Testingchore- Maintenance
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
💬 Support
If you have questions or need help:
- 📧 Email: aryadas.dev@gmail.com
- 🐛 GitHub Issues: Report bugs and request features
- 💼 LinkedIn: www.linkedin.com/in/aryaxplorer
- 🐦 Twitter (X): @AryaXplorer
Made with ❤️ by [Arya](https://github.com/arya-dev2005)