🛒 Medusa Clone

A modern e-commerce platform built from the ground up, inspired by MedusaJS architecture

🎯 Project Overview

This project is a learning journey into building a comprehensive e-commerce platform by recreating MedusaJS from scratch. Rather than forking or extending the original, I'm building each component to deeply understand the architecture and patterns that make modern e-commerce platforms tick.

✨ Features

🏗️ Current Implementation

• Modern Monorepo Setup - Turborepo-powered development environment
• Type-Safe Development - Full TypeScript integration
• Component Development - Storybook-driven UI development
• Advanced DataGrid - Interactive product variant management

🚧 In Development

• Interactive product creation forms
• File upload and gallery management
• Comprehensive admin dashboard
• Product catalog management

🛠️ Tech Stack

Core Technologies

• 🏎 Turborepo — High-performance monorepo build system
• 🚀 React — Modern UI library
• 📦 TypeScript — Type-safe JavaScript
• 🛠 Tsup — Lightning-fast TypeScript bundler

Development Tools

• 📖 Storybook — Component development environment
• 🔍 ESLint — Code quality enforcement
• ✨ Prettier — Code formatting (Coming Soon)
• 📝 Changesets — Version management (Coming Soon)

🗺️ Roadmap

Phase 1: Foundation (Current)

• Monorepo setup with Turborepo
• TypeScript configuration
• Storybook integration
• DataGrid component for product variants (In Progress)

Phase 2: Core Components

• Publish DataGrid as standalone npm package
• Gallery management system (CRUD + Drag & Drop)
• Form components library
• File upload utilities

Phase 3: Product Management

• Comprehensive product creation form
• Product catalog with search & filtering
• Inventory management
• Variant management system

Phase 4: Advanced Features

• Order management
• Customer management
• Analytics dashboard
• Multi-store support

🚀 Quick Start

# Clone the repository
git clone https://github.com/yourusername/medusa-clone.git
cd medusa-clone

# Install dependencies
pnpm install

# Start development server
pnpm dev

Visit http://localhost:6006 to see Storybook in action!

📜 Available Scripts

Command	Description
pnpm dev	Start all packages locally with Storybook preview
pnpm build	Build all packages for production
pnpm clean	Clean all build artifacts and node_modules

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

• MedusaJS for the inspiration and architectural patterns
• Vercel for the amazing developer tools ecosystem

---

⭐ Star this repo if you find it helpful!

Made with ❤️ by Bao Phan