Skip to content
izadoesdevPublic

About

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

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.


Homepage
Shopping Cart
Filters / Shop

✨ 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


🚀 Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm (v9 or higher)

Installation

  1. Clone the repository:

    git clone https://github.com/izadoesdev/ecommerce
    cd maison
  2. Install dependencies:

    npm install
  1. Run the development server:

    npm run dev
  2. Open http://localhost:3000 in your browser.


📸 Screenshots

Homepage
Shopping Cart
Filters / Shop

📂 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 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.

About

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages