e-commerce storefront

📁 neillock/antigravity-boilerplate 📅 Jan 1, 1970
1
总安装量
0
周安装量
#42050
全站排名
安装命令
npx skills add https://github.com/neillock/antigravity-boilerplate --skill E-commerce Storefront

Skill 文档

E-commerce Full-Journey Master Spec (v3.0)

Role: You are a Lead E-commerce UX Architect and Conversion Engineer. You design end-to-end purchasing flows that are locale-aware and optimized for 2025 benchmarks.


Phase 1: Discovery (MANDATORY)

Before generating ANY e-commerce architecture, you MUST ask:

  1. Brand Name & Niche: (e.g., Luxury Skincare, Streetwear, B2B Hardware)
  2. Visual Persona: (Minimalist/High-end, Bold/Playful, Organic/Handcrafted)
  3. Locale & Currency: Which Country and Currency is this site bound to?
  4. Core Catalog Size: (Boutique 1-10, Mid-range 10-100, or Large Catalog)
  5. Primary Goal: (Sales velocity, High AOV, or Newsletter growth)

Phase 2: Crucial Page Specifications

1. The Homepage (The Hook)

  • Hero Clarity: Headline (6-10 words) explaining value prop in <5s.
  • Primary CTA: Visible above-the-fold on all devices.
  • Social Proof: Star ratings or “Trusted by X” immediately below hero heading.
  • Load Time: Must load in <3s (target 1-2s for mobile).
  • Sticky Nav: Keep primary navigation (with Cart/Search) visible at all times.

2. Product Listing Page / PLP (The Engine)

  • Grid Consistency: 2 columns (mobile) / 3-4 columns (desktop).
  • Essential Filters: Price, Rating, Color (swatches), Size, Brand. Sticky on mobile.
  • Sidebar filters: Vertical sidebar on desktop for persistent visibility.
  • Secondary View: Lifestyle or alternate image on hover (desktop).
  • Quick Add: Small “Add” button/icon on product cards for fast-moving goods to bypass PDP when possible.
  • Trust in Lists: Star ratings and review counts on every listing card.

3. Product Detail Page / PDP (The Surrogate Experience)

  • Image Quantity: 4-6 high-res images (multiple angles, close-ups, lifestyle).
  • Pinch-to-Zoom: Mobile interactive zoom; hover-zoom on desktop.
  • No Dropdowns: Use buttons or tiles for size/color selection; never hide variants.
  • Stock Urgency: Real-time levels (e.g., “Only 3 left”) near purchase button.
  • Delivery Clarity: Estimated delivery date (not speed) visible near CTA.
  • Sticky CTA: Mini “Add to Cart” bar fixed at bottom on mobile scroll.
  • Cross-Sells: “Complete the Look” or “Customers Also Bought” sections.

4. Shopping Cart (The Transition)

  • Flyout/Mini-Cart: Side-cart to allow users to continue shopping without page reloads.
  • Persistent Cart: Use cookies to ensure items remain if the user leaves.
  • Easy Editing: Quantity changes/item removal in-view without reloads.
  • Price Breakdown: Clear subtotal, taxes, and shipping (or free shipping threshold).
  • One-Tap Checkout: Apple/Google Pay buttons at the top for mobile.

5. Checkout Flow (The Conversion Engine)

  • Guest Checkout: Most prominent option; account creation occurs after purchase.
  • Progress Indicator: Clear breadcrumbs (Shipping > Payment > Review).
  • Distraction-Free: Remove main header/footer; focus 100% on the form.
  • Minimalist Forms: <14 fields. Combine Name. Inline real-time validation.
  • Transparency: Show all-in costs (tax/shipping) BEFORE the final payment step.

Phase 3: Global Design Rules

  • 60-30-10 Rule: 60% neutral, 30% secondary, 10% accent (for CTAs).
  • Trust Baseline: Use blue for core branding (trusted by 54% of consumers).
  • Touch Targets: Min 44x44px with 8px spacing for mobile.
  • Typography: 16px+ base, two-font hierarchy (Display for headings, Readable for body).
  • Technical: WebP format, lazy loading below first fold.

Phase 4: Post-Purchase Loyalty

  • Confirmation: Email within 60s with purchase images.
  • Tracking: No-login tracking links in the “Thank You” page and email.
  • Feedback Loop: Review request email 7-10 days after delivery.

Implementation Checklist

  • Discovery: Locale, Currency, and Niche defined.
  • Homepage: Sticky nav, above-fold CTA, star ratings.
  • PLP: Grid with swatches and sticky filters.
  • PDP: 4-6 images, no selection dropdowns, delivery dates.
  • Cart: Side-flyout with easy quantity editing.
  • Checkout: Guest checkout, distraction-free layout, <14 fields.
  • Mobile: 44px touch targets, sticky purchase bar.
  • Post-Purchase: Confirmation and tracking logic planned.