Storefront + admin panel + inventory system — Vue 3 + Vite + TypeScript + Pinia
Part of ForgeDev — Structured work simulation for junior developers.
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.
# Install dependencies
npm install
# Start dev server (proxies /api to localhost:3000)
npm run devMake sure the backend is running on port 3000.
- 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
- Framework: Vue 3 (Composition API)
- Build: Vite
- State: Pinia
- Routing: Vue Router
- HTTP: Axios
- Language: TypeScript
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
- 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 useEUR - TODO: Wishlist — Not implemented, mentioned in comments
- Cart quantity — Decreasing quantity removes and re-adds the item (workaround)
| Repo | Role |
|---|---|
| forgedev-ecommerce-backend | Backend API |
| forgedev-ecommerce-react | React frontend (alternative) |
This project is dual-licensed. See LICENSE, COMMERCIAL-LICENSE.md, and CLA.md.
ForgeDev — https://forgedev.dev