Skip to content

About

Storefront + admin panel + inventory system

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ForgeDev E-commerce (Vue 3)

Storefront + admin panel + inventory system — Vue 3 + Vite + TypeScript + Pinia

Part of ForgeDev — Structured work simulation for junior developers.


🛒 What's This?

A Vue 3 frontend for an e-commerce platform. Includes product catalog with search/filter, shopping cart, checkout flow, order confirmation, and an admin dashboard for stock management.

This is a training codebase — it works, but it has intentional bugs, missing features, and messy patterns for you to find and fix.

🚀 Quick Start

# Install dependencies
npm install

# Start dev server (proxies /api to localhost:3000)
npm run dev

Make sure the backend is running on port 3000.

📋 Features

  • Storefront — Product grid with search and category filter
  • Product Detail — Full product info with stock status
  • Shopping Cart — Add/remove items, quantity controls
  • Checkout — Shipping form + order creation
  • Order Confirmation — Order summary after checkout
  • Admin Dashboard — Stock overview with low-stock alerts

🛠 Tech Stack

  • Framework: Vue 3 (Composition API)
  • Build: Vite
  • State: Pinia
  • Routing: Vue Router
  • HTTP: Axios
  • Language: TypeScript

📁 Project Structure

src/
├── api/
│   └── index.ts          # API client with all endpoints
├── assets/
│   └── main.css          # Global styles
├── components/
│   ├── ProductCard.vue   # Product card for grid
│   ├── CartItem.vue      # Cart line item
│   ├── CheckoutForm.vue  # Checkout shipping + payment form
│   ├── SearchBar.vue     # Product search
│   ├── FilterSidebar.vue # Category filter
│   └── StockDashboard.vue # Admin inventory table
├── router/
│   └── index.ts          # Route definitions
├── stores/
│   ├── products.ts       # Product catalog state
│   ├── cart.ts           # Shopping cart state
│   └── orders.ts         # Order state
├── views/
│   ├── StorefrontView.vue      # Main product grid
│   ├── ProductDetailView.vue   # Single product page
│   ├── CartView.vue            # Shopping cart page
│   ├── CheckoutView.vue        # Checkout flow
│   ├── OrderConfirmationView.vue # Order success page
│   └── AdminDashboardView.vue  # Admin stock dashboard
├── App.vue               # Root component with navbar
└── main.ts               # App entry point

⚠️ Known Issues (Intentional)

  • Cart not persisted — Cart state is lost on page refresh (should use localStorage)
  • Broken search — SearchBar fetches ALL products then filters client-side (inefficient + has a bug with accented characters)
  • Missing loading spinner — Product detail page has no loading indicator
  • Inline styles — ProductDetailView uses non-scoped inline <style> instead of <style scoped>
  • Inconsistent currency — Some components use €, others use EUR
  • TODO: Wishlist — Not implemented, mentioned in comments
  • Cart quantity — Decreasing quantity removes and re-adds the item (workaround)

🔗 Related Repositories

Repo Role
forgedev-ecommerce-backend Backend API
forgedev-ecommerce-react React frontend (alternative)

📜 License

This project is dual-licensed. See LICENSE, COMMERCIAL-LICENSE.md, and CLA.md.

ForgeDev — https://forgedev.dev

About

Storefront + admin panel + inventory system

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages