How prem7713/geartrade works
This is GearTrade, a used auto-parts marketplace with vehicle-aware discovery, product details, cart and checkout, bargain offers, customer accounts, and administrative management. The shopper flow begins at the storefront, continues through catalog and product interactions, then uses cart state to prepare checkout; the order API persists orders. Account and admin features form parallel workflows. Sampled source confirms key client-state, authentication, and API-to-database links; several route and page implementations were not sampled, so their internal connections are left unspecified.
Main entry points: prisma.ts Prisma Client · auth.ts Authentication · page.tsx Storefront · ProductCard.tsx Product Card
Components 20
Storefront & Catalog
- Storefront
app/page.tsx - Catalog Pages
app/shop/page.tsx - Vehicle Selector
components/VehicleSelector.tsx - Product Details
components/ProductDetailClient.tsx - Product Card
components/ProductCard.tsx
Purchase & Offers
- Product API
app/api/products/route.ts - Cart State
lib/cart-context.tsx - Checkout
app/checkout/page.tsx - Order API
app/api/orders/route.ts - Offers API
app/api/offers/route.ts - Bargain Flow
components/BargainModal.tsx
Identity & Accounts
- Customer Account
app/account/page.tsx - User State
lib/user-context.tsx - Authentication
lib/auth.ts - Auth Routes
app/api/auth
Administration
- Admin Console
app/admin - Admin Routes
app/api/admin
Runtime & Data
- Prisma Client
lib/prisma.ts - PostgreSQL Database
Other components
- Shopper
Connections 28
- Shopper → Storefront: browses
app/page.tsx - Storefront → Vehicle Selector: renders
app/page.tsx - Storefront → Product Card: renders
app/page.tsx - Storefront → Prisma Client: queries
app/page.tsx - Catalog Pages → Vehicle Selector: renders
app/shop/page.tsx - Catalog Pages → Product Card: renders
app/shop/page.tsx - Catalog Pages → Prisma Client: queries
app/shop/page.tsx - Product Details → Cart State: updates
components/ProductDetailClient.tsx - Product Details → Bargain Flow: opens
components/ProductDetailClient.tsx - Product Card → Cart State: updates
components/ProductCard.tsx - Product Card → Bargain Flow: opens
components/ProductCard.tsx - Product API → Authentication: checks user
app/api/products/route.ts - Product API → Prisma Client: reads/writes
app/api/products/route.ts - Checkout → Cart State: reads
app/checkout/page.tsx - Checkout → User State: reads
app/checkout/page.tsx - Order API → Authentication: checks user
app/api/orders/route.ts - Order API → Prisma Client: reads/writes
app/api/orders/route.ts - Bargain Flow → User State: reads
components/BargainModal.tsx - Offers API → Authentication: checks user
app/api/offers/route.ts - Offers API → Prisma Client: reads/writes
app/api/offers/route.ts - Customer Account → Authentication: resolves user
app/account/page.tsx - Customer Account → Prisma Client: queries
app/account/page.tsx - User State → Auth Routes: fetches session
lib/user-context.tsx - Auth Routes → Authentication: uses auth
- Admin Console → Prisma Client: queries
app/admin/page.tsx - Admin Routes → Authentication: uses auth
- Prisma Client → PostgreSQL Database: connects
README.md - Authentication → Prisma Client: loads user
lib/auth.ts