An open API service indexing awesome lists of open source software.

https://github.com/ayokanmi-adejola/ecommerce-platform

A comprehensive, dynamically scalable, and globally accessible full-stack e-commerce application, meticulously engineered to provide a seamless and personalized shopping experience, featuring robust user authentication protocols for secure access.
https://github.com/ayokanmi-adejola/ecommerce-platform

framer-motion lucide-react react18 shadcn-ui tailwindcss typescript

Last synced: 9 months ago
JSON representation

A comprehensive, dynamically scalable, and globally accessible full-stack e-commerce application, meticulously engineered to provide a seamless and personalized shopping experience, featuring robust user authentication protocols for secure access.

Awesome Lists containing this project

README

          

# Ecommerce Platform

A modern e-commerce platform for Adejola & Sons Enterprise, showcasing their premium artisanal ice cream products.

image

## ๐Ÿฆ About

Adejola & Sons Enterprise specializes in distributing premium artisanal ice cream. Our web platform provides a seamless shopping experience for customers to explore and purchase our delicious ice cream products. ๐Ÿ›๏ธ

## โญ Features

- ๐ŸŽจ Elegant, responsive design
- ๐Ÿ“ฑ Mobile-optimized interface
- ๐Ÿ” Product search and filtering
- ๐Ÿ›’ Real-time shopping cart
- โœจ Smooth animations and transitions
- ๐Ÿ“ฆ Product catalog with categories
- ๐Ÿ”’ Secure checkout process

## ๐Ÿ› ๏ธ Tech Stack

- **Framework:** โš›๏ธ React 18 with TypeScript
- **Build Tool:** โšก Vite
- **Styling:**
- ๐ŸŽญ Tailwind CSS
- ๐ŸŽช Shadcn UI Components
- ๐ŸŒŸ Custom animations with Framer Motion
- **State Management:** ๐Ÿ”„ React Query
- **Routing:** ๐Ÿ›ฃ๏ธ React Router DOM
- **UI Enhancements:**
- ๐Ÿ”” Sonner for toast notifications
- ๐ŸŽฏ Lucide React for icons
- ๐Ÿ“ React Hook Form for form handling

## ๐Ÿ“ฆ Getting Started

1. Clone the repository:
```bash
git clone https://github.com/Ayokanmi-Adejola/Ecommerce
cd Ecommerce
```

2. Install dependencies:
```bash
npm install
```

3. Start the development server:
```bash
npm run dev
```

## โš™๏ธ Available Scripts

- ๐Ÿš€ `npm run dev` - Launch development server
- ๐Ÿ“ฆ `npm run build` - Create production build
- ๐Ÿ”ง `npm run build:dev` - Create development build
- ๐Ÿ‘€ `npm run preview` - Preview production build
- ๐Ÿงน `npm run lint` - Run ESLint

## ๐Ÿ“ Project Structure

```
src/
โ”œโ”€โ”€ components/ # ๐Ÿงฉ UI components
โ”‚ โ”œโ”€โ”€ ui/ # ๐ŸŽจ Shadcn UI components
โ”‚ โ””โ”€โ”€ ... # โœจ Custom components
โ”œโ”€โ”€ pages/ # ๐Ÿ“„ Route pages
โ”œโ”€โ”€ hooks/ # ๐ŸŽฃ Custom React hooks
โ”œโ”€โ”€ context/ # ๐ŸŒ React Context providers
โ”œโ”€โ”€ lib/ # ๐Ÿ› ๏ธ Utility functions
โ””โ”€โ”€ types/ # ๐Ÿ“ TypeScript definitions
```

## ๐Ÿš€ Deployment

The site is deployed on Netlify. For deployment:

1. ๐Ÿ”— Connect your GitHub repository to Netlify
2. โš™๏ธ Configure build settings:
- Build command: `npm run build`
- Publish directory: `dist`
3. ๐ŸŽ‰ Deploy!

## ๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request. ๐ŸŽ‰

1. ๐Ÿด Fork the repository
2. ๐ŸŒฟ Create your feature 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