{"id":28002916,"url":"https://github.com/misbahul-alam/shopping-bag","last_synced_at":"2026-05-05T09:31:29.244Z","repository":{"id":289856139,"uuid":"972621992","full_name":"misbahul-alam/Shopping-Bag","owner":"misbahul-alam","description":"A  scalable full-stack eCommerce app using NestJS, TypeORM, PostgreSQL, and Next.js with authentication, product catalog, cart, orders, and address management.","archived":false,"fork":false,"pushed_at":"2025-05-02T14:35:22.000Z","size":251,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-02T15:43:16.613Z","etag":null,"topics":["nestjs","nextjs","postgresql","typeorm","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/misbahul-alam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-25T11:34:20.000Z","updated_at":"2025-05-02T14:35:26.000Z","dependencies_parsed_at":"2025-05-01T14:45:54.959Z","dependency_job_id":null,"html_url":"https://github.com/misbahul-alam/Shopping-Bag","commit_stats":null,"previous_names":["misbahul-alam/shopping-bag"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/misbahul-alam%2FShopping-Bag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/misbahul-alam%2FShopping-Bag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/misbahul-alam%2FShopping-Bag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/misbahul-alam%2FShopping-Bag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/misbahul-alam","download_url":"https://codeload.github.com/misbahul-alam/Shopping-Bag/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253176443,"owners_count":21866142,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nestjs","nextjs","postgresql","typeorm","typescript"],"created_at":"2025-05-09T01:44:38.925Z","updated_at":"2026-05-05T09:31:29.235Z","avatar_url":"https://github.com/misbahul-alam.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shopping-Bag 🛍️\n\nA modern full-stack e-commerce application built with Next.js and NestJS, offering a seamless shopping experience with a clean, minimalist design philosophy.\n\n## 📋 Overview\n\nShopping-Bag is an e-commerce platform that focuses on delivering carefully curated products with an emphasis on quality essentials and thoughtful design. The application features a responsive frontend built with Next.js and React, backed by a robust NestJS API.\n\n## ✨ Features\n\n- 🎨 Modern, responsive UI with Tailwind CSS and DaisyUI\n- 🛒 Product browsing with category carousels\n- 📱 Mobile-first responsive design\n- 🔐 User authentication (Login/Register)\n- 🏪 Shop and product detail pages\n- 🎯 Featured products, new arrivals, and best sellers sections\n- 📦 Shopping cart functionality\n- 🎭 Clean and intuitive user interface\n\n## 🛠️ Tech Stack\n\n### Frontend\n\n- **Framework:** Next.js 16 (React 19)\n- **Language:** TypeScript\n- **Styling:** Tailwind CSS, DaisyUI\n- **State Management:** Zustand\n- **UI Components:** Custom components with react-icons\n- **Carousel:** Embla Carousel React\n- **Package Manager:** pnpm\n\n### Backend\n\n- **Framework:** NestJS 11\n- **Language:** TypeScript\n- **Runtime:** Node.js\n- **Package Manager:** pnpm\n\n## 📁 Project Structure\n\n```\nshopping-bag/\n├── frontend/              # Next.js frontend application\n│   ├── src/\n│   │   ├── app/          # Next.js app directory (pages \u0026 routes)\n│   │   ├── components/   # Reusable React components\n│   │   ├── store/        # Zustand state management\n│   │   └── images/       # Static image assets\n│   └── public/           # Public static files\n├── backend/              # NestJS backend API\n│   ├── src/\n│   │   ├── app.module.ts\n│   │   ├── app.controller.ts\n│   │   ├── app.service.ts\n│   │   └── main.ts\n│   └── test/             # E2E tests\n└── old-backend/          # Legacy backend (deprecated)\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Node.js (v18 or higher)\n- pnpm (recommended) or npm\n- Git\n\n### Installation\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/misbahul-alam/Shopping-Bag.git\n   cd Shopping-Bag\n   ```\n\n2. **Install frontend dependencies**\n\n   ```bash\n   cd frontend\n   pnpm install\n   ```\n\n3. **Install backend dependencies**\n   ```bash\n   cd backend\n   pnpm install\n   ```\n\n### Running the Application\n\n#### Development Mode\n\n1. **Start the backend server**\n\n   ```bash\n   cd backend\n   pnpm run start:dev\n   ```\n\n   The backend will run on `http://localhost:3000`\n\n2. **Start the frontend development server**\n   ```bash\n   cd frontend\n   pnpm run dev\n   ```\n   The frontend will run on `http://localhost:3000` (or next available port)\n\n#### Production Mode\n\n1. **Build and start the backend**\n\n   ```bash\n   cd backend\n   pnpm run build\n   pnpm run start:prod\n   ```\n\n2. **Build and start the frontend**\n   ```bash\n   cd frontend\n   pnpm run build\n   pnpm run start\n   ```\n\n## 📜 Available Scripts\n\n### Frontend Scripts\n\n- `pnpm dev` - Start development server\n- `pnpm build` - Build for production\n- `pnpm start` - Start production server\n- `pnpm lint` - Run ESLint\n\n### Backend Scripts\n\n- `pnpm run start` - Start the application\n- `pnpm run start:dev` - Start in watch mode\n- `pnpm run start:debug` - Start in debug mode\n- `pnpm run start:prod` - Start production build\n- `pnpm run build` - Build the application\n- `pnpm run test` - Run unit tests\n- `pnpm run test:e2e` - Run end-to-end tests\n- `pnpm run test:cov` - Run tests with coverage\n- `pnpm run lint` - Run ESLint and fix issues\n- `pnpm run format` - Format code with Prettier\n\n## 🎨 Key Features in Detail\n\n### Frontend Pages\n\n- **Home Page** - Hero section with featured products, new arrivals, and best sellers\n- **Shop Page** - Browse all products with filtering options\n- **Product Detail** - Detailed product information and purchase options\n- **Login/Register** - User authentication pages\n- **Cart** - Shopping cart management\n\n### Component Architecture\n\n- **Layout Components** - Header, Footer, Drawer, MainLayout\n- **UI Components** - Button, InputField, SelectField, TextArea\n- **Feature Components** - ProductCard, CategoryCarousel\n\n## 🔧 Configuration\n\n### Environment Variables\n\nCreate `.env` files in both frontend and backend directories:\n\n**Backend `.env`:**\n\n```env\nPORT=3000\n# Add your environment variables here\n```\n\n**Frontend `.env.local`:**\n\n```env\nNEXT_PUBLIC_API_URL=http://localhost:3000\n# Add your environment variables here\n```\n\n## 🧪 Testing\n\nRun tests in the backend:\n\n```bash\ncd backend\npnpm run test        # Unit tests\npnpm run test:e2e    # E2E tests\npnpm run test:cov    # Coverage report\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the UNLICENSED license.\n\n## 👤 Author\n\n**Misbahul Alam**\n\n- GitHub: [@misbahul-alam](https://github.com/misbahul-alam)\n\n## 🙏 Acknowledgments\n\n- Next.js team for the amazing framework\n- NestJS team for the robust backend framework\n- The open-source community for the excellent tools and libraries\n\n---\n\n**Note:** This project is currently in active development. Some features may be incomplete or subject to change.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisbahul-alam%2Fshopping-bag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmisbahul-alam%2Fshopping-bag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisbahul-alam%2Fshopping-bag/lists"}