https://github.com/izadoesdev/ecommerce
https://github.com/izadoesdev/ecommerce
Last synced: about 20 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/izadoesdev/ecommerce
- Owner: izadoesdev
- Created: 2025-03-11T18:42:28.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-07-12T18:29:58.000Z (12 months ago)
- Last Synced: 2026-07-07T13:29:16.823Z (3 days ago)
- Language: TypeScript
- Homepage: https://ecommerce-eta-gules-66.vercel.app
- Size: 3.7 MB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.MD
Awesome Lists containing this project
README
# MAISON - Modern E-commerce Platform
MAISON is a beautifully designed, modern e-commerce platform built with **Next.js**, **Tailwind CSS**, and **Radix UI**. It offers a seamless shopping experience with a focus on performance, accessibility, and user experience.
---
## ✨ Features
- **E-commerce Essentials**:
- Product browsing with advanced filtering and sorting
- Shopping cart and wishlist functionality
- Quick view and product details
- **Internationalization (i18n)**:
- Multi-language support (English, French, Spanish, Arabic)
- Localized content and currency
- **Beautiful UI/UX**:
- Radix UI components for accessibility
- Tailwind CSS for responsive and customizable styling
- Lucide React icons for consistent iconography
- Framer Motion for smooth animations
- **Modern Development**:
- TypeScript for type safety
- React Hook Form for form management
- Zod for schema validation
- Next.js App Router for routing
- **Data Visualization**:
- Recharts for interactive charts and graphs
- **Date Handling**:
- `date-fns` for date manipulation
- `react-day-picker` for intuitive date pickers
- **Carousels**:
- Embla Carousel for smooth and responsive product carousels
- **Utilities**:
- Sonner for toast notifications
- Vaul for accessible modals
- Tailwind Merge for dynamic class management
---
## 🛠️ Tech Stack
- **Framework**: [Next.js 15.1.0](https://nextjs.org/)
- **Styling**: [Tailwind CSS](https://tailwindcss.com/) with animations
- **UI Components**: [Radix UI](https://www.radix-ui.com/), [Lucide React](https://lucide.dev/)
- **State Management**: [React Hook Form](https://react-hook-form.com/), [Zod](https://zod.dev/)
- **Internationalization**: [i18next](https://www.i18next.com/), [react-i18next](https://react.i18next.com/)
- **Animation**: [Framer Motion](https://www.framer.com/motion/)
- **Charts**: [Recharts](https://recharts.org/)
- **Type Safety**: [TypeScript](https://www.typescriptlang.org/), [Zod](https://zod.dev/)
- **Date Handling**: [date-fns](https://date-fns.org/), [react-day-picker](https://react-day-picker.js.org/)
- **Carousels**: [Embla Carousel](https://www.embla-carousel.com/)
- **Utilities**: [Sonner](https://sonner.emilkowal.ski/), [Vaul](https://vaul.emilkowal.ski/), [Tailwind Merge](https://github.com/dcastil/tailwind-merge)
---
## 🚀 Getting Started
### Prerequisites
- Node.js (v18 or higher)
- npm (v9 or higher)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/izadoesdev/ecommerce
cd maison
```
2. Install dependencies:
```bash
npm install
```
4. Run the development server:
```bash
npm run dev
```
5. Open [http://localhost:3000](http://localhost:3000) in your browser.
---
## 📸 Screenshots
---
## 📂 Folder Structure
```
maison/
├── app/ # Next.js app router
├── components/ # Reusable React components
├── lib/ # Utilities, helpers, and data
├── styles/ # Global styles and Tailwind config
├── public/ # Static assets (images, fonts, etc.)
├── hooks/ # Custom React hooks
├── types/ # TypeScript types and interfaces
├── i18n/ # Internationalization setup
├── package.json # Project dependencies
└── README.md # Project documentation
```
---
## 🛠️ Scripts
- `dev`: Start the development server
- `build`: Build the project for production
- `start`: Start the production server
- `lint`: Run ESLint for code linting
---
## 🤝 Contributing
We welcome contributions! Here's how you can help:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/AmazingFeature`).
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
4. Push to the branch (`git push origin feature/AmazingFeature`).
5. Open a Pull Request.
Please ensure your code follows the project's coding standards and includes appropriate tests.
---
## 📄 License
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.
---
## 🙏 Acknowledgments
- The **Next.js** team for the amazing framework.
- **Tailwind CSS** for the utility-first CSS framework.
- **Radix UI** for accessible and composable UI components.
- All the open-source contributors of the dependencies used in this project.
---