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.
- Host: GitHub
- URL: https://github.com/ayokanmi-adejola/ecommerce-platform
- Owner: Ayokanmi-Adejola
- License: mit
- Created: 2025-04-04T20:39:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-03T15:56:37.000Z (11 months ago)
- Last Synced: 2025-10-20T06:57:47.690Z (9 months ago)
- Topics: framer-motion, lucide-react, react18, shadcn-ui, tailwindcss, typescript
- Language: TypeScript
- Homepage: https://adejola-global-giant.netlify.app/
- Size: 2.43 MB
- Stars: 15
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ecommerce Platform
A modern e-commerce platform for Adejola & Sons Enterprise, showcasing their premium artisanal ice cream products.

## ๐ฆ 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