Volt & Spoke Demo Store — Homepage Widget Configuration Guide

homepage.md

Volt & Spoke — Homepage Setup Guide

How to use this guide

Option A — PageBuilder (manual): Follow the step-by-step instructions under each widget. Add widgets in order, copy-paste the text fields, and upload the provided images.

Option B — API (automated): Use the widget_configuration JSON blocks with the BigCommerce Widgets API to create and place widgets programmatically.

All images are pre-generated and hosted on the BigCommerce CDN — just copy the URLs.

---

1. Hero Banner Carousel

PageBuilder → Add Widget → Hero Banner Carousel → Place in Header Bottom region

Setup Instructions

Field	Value
Large Image	Upload from URL below or drag into Image Manager
Image Max Height	600 px
Alt Text	Electric mountain bike on a mountain trail at golden hour
Sub Heading	Volt & Spoke
Heading	Electric Bikes. Built to Ride.
Description	Real-world range ratings. Serviceable components. Factory-direct pricing.
Button Text	Shop E-Bikes
Button Link	/ebikes/
Button BG Color	#2563EB
Button Text Color	#FFFFFF

Hero Image URL (right-click → Copy Image Address → paste into Image Manager):

https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863312__96314.png

API widget_configuration JSON

{
  "carousel_items": [
    {
      "mainImageSrc": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863312__96314.png", "type": "IMAGE_MANAGER" },
      "smallImageSrc": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863312__96314.png", "type": "IMAGE_MANAGER" },
      "mainImageMaxHeight": { "value": 600, "type": "px" },
      "mainImageAlt": "Electric mountain bike on a mountain trail at golden hour",
      "sub_heading_text": "Volt & Spoke",
      "heading_text": "Electric Bikes. Built to Ride.",
      "description_text": "Real-world range ratings. Serviceable components. Factory-direct pricing.",
      "slideButtonDisplay": true,
      "slideButtonText": "Shop E-Bikes",
      "slideButtonLink": "/ebikes/",
      "slideButtonBGColor": "#2563EB",
      "slideButtonTextColor": "#FFFFFF",
      "slideButtonHoverBGColor": "#1D4ED8",
      "slideButtonTextHoverColor": "#FFFFFF"
    }
  ]
}

Widget UUID: 77828053-2156-4b49-b331-2d72ac05e96f | Region: header_bottom | Sort: 0

---

2. Featured Categories

PageBuilder → Add Widget → Featured Categories → Place in Body region

Setup Instructions

Section Title: Find Your Ride

Category 1 — Mountain

Field	Value
Image	Upload from URL below
Title	Mountain
Button Title	Shop Mountain
Category URL	/mountain-e-bikes/

https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863313__81844.png

Category 2 — Commuter

Field	Value
Image	Upload from URL below
Title	Commuter
Button Title	Shop Commuter
Category URL	/commuter-e-bikes/

https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863313__43994.png

Category 3 — Adventure

Field	Value
Image	Upload from URL below
Title	Adventure
Button Title	Shop Adventure
Category URL	/adventure-e-bikes/

https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863314__86973.png

API widget_configuration JSON

{
  "section_title": "Find Your Ride",
  "mobile_cap": true,
  "product_categories": [
    {
      "category_item_image": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863313__81844.png", "type": "IMAGE_MANAGER" },
      "category_item_overlay_color": "#000",
      "category_item_title": "Mountain",
      "category_item_button_title": "Shop Mountain",
      "category_url": "/mountain-e-bikes/"
    },
    {
      "category_item_image": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863313__43994.png", "type": "IMAGE_MANAGER" },
      "category_item_overlay_color": "#000",
      "category_item_title": "Commuter",
      "category_item_button_title": "Shop Commuter",
      "category_url": "/commuter-e-bikes/"
    },
    {
      "category_item_image": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863314__86973.png", "type": "IMAGE_MANAGER" },
      "category_item_overlay_color": "#000",
      "category_item_title": "Adventure",
      "category_item_button_title": "Shop Adventure",
      "category_url": "/adventure-e-bikes/"
    }
  ]
}

Widget UUID: f9afdc9c-7abc-463f-96b6-fc69e4e31cad | Region: body | Sort: 1

---

3. Value Proposition

PageBuilder → Add Widget → Value Proposition → Place in Body region

Setup Instructions

Section Title: Why Volt & Spoke Section Subtitle: (leave empty)

Prop 1

Field	Value
Title	Real-World Range
Subtitle	Tested on trails, not treadmills. Every range number comes from actual rides with real elevation gain.

Prop 2

Field	Value
Title	Serviceable Design
Subtitle	Standard bottom brackets, headsets, and bearings. Any qualified bike mechanic can service your ride.

Prop 3

Field	Value
Title	Factory Direct
Subtitle	No middleman markup. When you call us, you talk to someone who helped build your bike.

Prop 4

Field	Value
Title	Industry-Leading Warranty
Subtitle	Lifetime frame warranty. 3-year motor & battery. 2-year on all components.

API widget_configuration JSON

{
  "value_prop_section_title": "Why Volt & Spoke",
  "value_prop_section_subtitle": "",
  "value_props": [
    { "prop_item_title": "Real-World Range", "prop_item_subtitle": "Tested on trails, not treadmills. Every range number comes from actual rides with real elevation gain." },
    { "prop_item_title": "Serviceable Design", "prop_item_subtitle": "Standard bottom brackets, headsets, and bearings. Any qualified bike mechanic can service your ride." },
    { "prop_item_title": "Factory Direct", "prop_item_subtitle": "No middleman markup. When you call us, you talk to someone who helped build your bike." },
    { "prop_item_title": "Industry-Leading Warranty", "prop_item_subtitle": "Lifetime frame warranty. 3-year motor & battery. 2-year on all components." }
  ]
}

Widget UUID: 21c92ed1-9c71-43b1-ac49-655942e8277c | Region: body | Sort: 2

---

4. Image / Text (Brand Story)

PageBuilder → Add Widget → Image / Text → Place in Body region

Setup Instructions

Field	Value
Image	Upload from URL below
Image Width	760 px
Image Alt Text	Volt & Spoke workshop — bikes being assembled with care
Link	/about/
Heading	Our Story
Heading Type	H2
Sub Heading	Built in Boulder, Colorado
Sub Heading Type	H4
Button Text	Read Our Story
Button URL	/about/

Body Text (paste into the rich text/code field):

We don't publish lab-condition range numbers. Every range rating on our bikes comes from real-world testing — on actual trails, with real elevation gain, by actual riders.

We engineer every bike to be serviced by any qualified bicycle mechanic. Standard bottom brackets. Standard headsets. Standard bearings. When a component wears out, you replace it without proprietary tools.

Workshop Image URL:

https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863315__33601.png

API widget_configuration JSON

{
  "mainImageSrc": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863315__33601.png", "type": "IMAGE_MANAGER" },
  "imageWidth": { "value": 760, "type": "px" },
  "mainImageAlt": "Volt & Spoke workshop — bikes being assembled with care",
  "link_url": "/about/",
  "heading_text": "Our Story",
  "headingType": "h2",
  "sub_heading_text": "Built in Boulder, Colorado",
  "subHeadingType": "h4",
  "main_text": "<p>We don't publish lab-condition range numbers. Every range rating on our bikes comes from real-world testing — on actual trails, with real elevation gain, by actual riders.</p><p>We engineer every bike to be serviced by any qualified bicycle mechanic. Standard bottom brackets. Standard headsets. Standard bearings. When a component wears out, you replace it without proprietary tools.</p>",
  "button_text": "Read Our Story",
  "button_url": "/about/"
}

Widget UUID: 257e8088-e951-4a5e-b607-74377c9fb8af | Region: body | Sort: 3

---

5. Promotional Panel (Accessories CTA)

PageBuilder → Add Widget → Promotional Panel → Place in Body region

Setup Instructions

Field	Value
Background Image	Upload from URL below
Title	Complete Your Ride
Message	Helmets, lights, bags, tools, and spare batteries — everything you need to get the most out of your Volt & Spoke bike.
Button Text	Shop Accessories
Link URL	/accessories/
Overlay Color	#1E293B
Title Color	#FFFFFF
Message Color	#FFFFFF
Button BG Color	#2563EB
Button Text Color	#FFFFFF

Background Image URL:

https://cdn11.bigcommerce.com/s-nrwsrejyil/products/141/images/578/product__49986.1773869286.1280.1280.jpg?c=1

API widget_configuration JSON

{
  "promotional_banner_image": { "src": "https://cdn11.bigcommerce.com/s-nrwsrejyil/products/141/images/578/product__49986.1773869286.1280.1280.jpg?c=1", "type": "IMAGE_MANAGER" },
  "promotional_banner_title": "Complete Your Ride",
  "promotional_banner_message": "Helmets, lights, bags, tools, and spare batteries — everything you need to get the most out of your Volt & Spoke bike.",
  "promotional_banner_button_title": "Shop Accessories",
  "promotional_banner_url": "/accessories/",
  "promotional_banner_overlay_color": "#1E293B",
  "promotional_banner_title_color": "#FFFFFF",
  "promotional_banner_message_color": "#FFFFFF",
  "promotional_banner_button_bg_color": "#2563EB",
  "promotional_banner_button_text_color": "#FFFFFF",
  "promotional_banner_button_bg_hover_color": "#FFFFFF",
  "promotional_banner_button_text_hover_color": "#2563EB"
}

Widget UUID: e9c65ba7-cc64-4c44-8890-95235ebb7695 | Region: body | Sort: 4

---

6. Testimonials Carousel

PageBuilder → Add Widget → Testimonials Carousel → Place in Body region

Setup Instructions

Section Title: What Riders Say

Review 1

Field	Value
Description	I've owned three e-bikes before the Ridgeline Pro. None of them published honest range numbers. Volt & Spoke says 55 miles on mixed singletrack — I got 58. First company that under-promised and over-delivered.
Author	Marcus T.
Rating	5 stars

Review 2

Field	Value
Description	Replaced my car commute with the Metro GT six months ago. The integrated lights and fenders mean I ride rain or shine. Best purchase I've made in years.
Author	Sarah K.
Rating	5 stars

Review 3

Field	Value
Description	Had to replace the brake pads at 2,000 miles. Walked into my local bike shop, they had the parts in stock and did it in 15 minutes. That's what serviceable design means.
Author	James R.
Rating	4.5 stars

Review 4

Field	Value
Description	The Expedition 750 handled a 200-mile bikepacking trip through the Rockies without a single issue. The 720Wh battery plus the spare got me through every day with range to spare.
Author	Elena M.
Rating	5 stars

Review 5

Field	Value
Description	Customer service is unreal. Had a question about tire pressure for my Gravel X — the person who answered literally worked on the assembly line. You can't get that anywhere else.
Author	David C.
Rating	5 stars

API widget_configuration JSON

{
  "title": "What Riders Say",
  "items": [
    { "description": "I've owned three e-bikes before the Ridgeline Pro. None of them published honest range numbers. Volt & Spoke says 55 miles on mixed singletrack — I got 58. First company that under-promised and over-delivered.", "author": "Marcus T.", "rating": "5" },
    { "description": "Replaced my car commute with the Metro GT six months ago. The integrated lights and fenders mean I ride rain or shine. Best purchase I've made in years.", "author": "Sarah K.", "rating": "5" },
    { "description": "Had to replace the brake pads at 2,000 miles. Walked into my local bike shop, they had the parts in stock and did it in 15 minutes. That's what serviceable design means.", "author": "James R.", "rating": "4.5" },
    { "description": "The Expedition 750 handled a 200-mile bikepacking trip through the Rockies without a single issue. The 720Wh battery plus the spare got me through every day with range to spare.", "author": "Elena M.", "rating": "5" },
    { "description": "Customer service is unreal. Had a question about tire pressure for my Gravel X — the person who answered literally worked on the assembly line. You can't get that anywhere else.", "author": "David C.", "rating": "5" }
  ]
}

Widget UUID: 4005558f-a492-445e-bff0-6a823d2f437e | Region: body | Sort: 5

---

Quick Reference: All Image URLs

Copy these into PageBuilder's Image Manager:

Image	URL
Hero banner	https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863312__96314.png
Mountain category	https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863313__81844.png
Commuter category	https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863313__43994.png
Adventure category	https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863314__86973.png
Workshop / brand story	https://cdn11.bigcommerce.com/s-nrwsrejyil/product_images/logo_1773863315__33601.png
Accessories promo	https://cdn11.bigcommerce.com/s-nrwsrejyil/products/141/images/578/product__49986.1773869286.1280.1280.jpg?c=1

Brand Colors

Color	Hex	Usage
Primary Blue	#2563EB	Buttons, accents
Primary Blue Hover	#1D4ED8	Button hover states
Dark Slate	#1E293B	Dark backgrounds, overlays
White	#FFFFFF	Text on dark backgrounds