Skip to content

A fully functional e-commerce store with a modern, polished design and engaging animations.

License

Notifications You must be signed in to change notification settings

Ayyubiy90/modern-e-commerce-store

Repository files navigation

🛍️ ModernStore - React E-commerce Platform

A modern, fully-featured e-commerce platform built with React, TypeScript, and Tailwind CSS.

ModernStore Screenshot

✨ Features

  • 🎯 Modern, responsive design
  • 🛒 Real-time cart management
  • 🔍 Product search functionality
  • 💳 Secure payment processing with Stripe
  • 🎭 Smooth animations with Framer Motion
  • 📱 Mobile-first approach
  • 🎨 Beautiful UI with Tailwind CSS
  • 🔄 State management with Zustand

🚀 Getting Started

Prerequisites

  • Node.js 16.x or later
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/Ayyubiy90/modern-e-commerce-store.git
cd modern-e-commerce-store
  1. Install dependencies:
npm install
  1. Configure environment variables: Create a .env file in the root directory and add your Stripe publishable key:
VITE_STRIPE_PUBLISHABLE_KEY=your_publishable_key
  1. Start the development server:
npm run dev

🏗️ Project Structure

src/
├── components/        # React components
├── store/            # State management
├── lib/              # Utility functions
├── types/            # TypeScript types
└── data/            # Mock data

🧱 Tech Stack

  • Frontend Framework: React with TypeScript
  • Styling: Tailwind CSS
  • State Management: Zustand
  • Animations: Framer Motion
  • Icons: Lucide React
  • Payment Processing: Stripe
  • Build Tool: Vite

🔒 Security

  • Secure payment processing with Stripe
  • Environment variables for sensitive data
  • Type-safe code with TypeScript

🎨 Design Principles

  • Clean, minimalist UI
  • Responsive design for all devices
  • Smooth animations and transitions
  • Intuitive user experience
  • Accessible components

📝 Development Guidelines

  1. Follow TypeScript best practices
  2. Use functional components with hooks
  3. Implement proper error handling
  4. Write clean, maintainable code
  5. Follow the component-based architecture

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Product images from Unsplash
  • Icons from Lucide React
  • UI inspiration from modern e-commerce platforms