From d24c8acc17fa45ec2198ee0f04d8b4934c4535aa Mon Sep 17 00:00:00 2001 From: Thomas Kimura Date: Fri, 3 Oct 2025 09:02:17 -0400 Subject: [PATCH 1/5] Add advanced menu layouts/mega menu guide --- general/advanced-menu-layouts.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 general/advanced-menu-layouts.md diff --git a/general/advanced-menu-layouts.md b/general/advanced-menu-layouts.md new file mode 100644 index 0000000..74d4bc5 --- /dev/null +++ b/general/advanced-menu-layouts.md @@ -0,0 +1,11 @@ +# Advanced Menu Layouts + +Our themes support horizontal (mega menu) and vertical menus. Paper and Keystone have flexible header menu options. + +To create a mega menu: +- In Theme Editor, set Header > Menu Layout to horizontal +- Add two or more columns and menu cards (for images, descriptions) +- Use 'Show as mega menu' toggle for Paper/Keystone +- To fix menu reverting to vertical, make sure top-level menu items have children assigned + +Troubleshooting: If your mega menu won't display, double check your nesting and that you've saved changes. Some upgrades (6.x → 8.x or on Paper/Keystone) may reset your menu settings. \ No newline at end of file From 5cc269047d2e7996053572b66b033094d3dd3f16 Mon Sep 17 00:00:00 2001 From: Thomas Kimura Date: Fri, 3 Oct 2025 09:02:17 -0400 Subject: [PATCH 2/5] Add doc on optimizing collection grid performance --- general/collection-grid-performance.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 general/collection-grid-performance.md diff --git a/general/collection-grid-performance.md b/general/collection-grid-performance.md new file mode 100644 index 0000000..1391c9c --- /dev/null +++ b/general/collection-grid-performance.md @@ -0,0 +1,10 @@ +# Optimizing Collection Grid Performance + +If your collection/product grid is slow to load or seems to freeze, especially with collections with many variants/images: + +- Check 'Show variants table' in your product or collection settings—disabling this can substantially speed up DOM load time +- Limit the number of visible products per page (e.g. 24) +- Theme loads images for all variants—if you have >10 images per product, this adds up fast +- Try disabling "load more" pagination if it makes load speeds worse + +For further optimization tips, visit [Shopify's collection performance guide](https://help.shopify.com/). \ No newline at end of file From 7d7538f4f7e0f54aa6c5eeaceb8ed7eca4f9252d Mon Sep 17 00:00:00 2001 From: Thomas Kimura Date: Fri, 3 Oct 2025 09:02:48 -0400 Subject: [PATCH 3/5] Add theme upgrade and customization tips --- general/theme-upgrade-customization.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 general/theme-upgrade-customization.md diff --git a/general/theme-upgrade-customization.md b/general/theme-upgrade-customization.md new file mode 100644 index 0000000..973305a --- /dev/null +++ b/general/theme-upgrade-customization.md @@ -0,0 +1,10 @@ +# Theme Upgrade & Customization Tips + +Upgrading Paper, Keystone, or Space? Make sure to: +- Review changes to header, navigation, and color settings +- If menu, accent, or background colors look off, manually re-assign your 'Accent 1' in the updated theme settings +- For custom code, test every page before publishing +- After major upgrades (v5 to v8), configuration for menus and page sections may reset +- See [menu troubleshooting](menu-troubleshooting.md) + +For extra theme tweaks (rounded boxes, hiding collection names), see the relevant theme’s documentation (Keystone, Paper, or Space folders above). \ No newline at end of file From 2d1767a19d4dc430da58ab705278c2d3e905b6e7 Mon Sep 17 00:00:00 2001 From: Thomas Kimura Date: Fri, 3 Oct 2025 09:02:55 -0400 Subject: [PATCH 4/5] Create onboarding/rescheduling mini-guide --- general/onboarding-rescheduling-guide.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 general/onboarding-rescheduling-guide.md diff --git a/general/onboarding-rescheduling-guide.md b/general/onboarding-rescheduling-guide.md new file mode 100644 index 0000000..d183362 --- /dev/null +++ b/general/onboarding-rescheduling-guide.md @@ -0,0 +1,10 @@ +# Onboarding & Support Call Guide + +Need to reschedule your onboarding or support demo? + +1. Visit your scheduling link in your onboarding email (or use [this link](https://cal.com/brickspacelab/onboarding)) +2. If a mistake was made, just reply to your onboarding email or contact [support](contact-support.md) +3. For theme support tickets, always double check your time zone before booking +4. You’ll receive a confirmation email for every scheduled/rescheduled call + +Reach out if you run into any problems! \ No newline at end of file From 138b014ec87e5c4afc3c30f5233f4f6158af7395 Mon Sep 17 00:00:00 2001 From: Thomas Kimura Date: Fri, 3 Oct 2025 09:03:01 -0400 Subject: [PATCH 5/5] Add menu and menu drawer troubleshooting article --- general/menu-troubleshooting.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 general/menu-troubleshooting.md diff --git a/general/menu-troubleshooting.md b/general/menu-troubleshooting.md new file mode 100644 index 0000000..6234e60 --- /dev/null +++ b/general/menu-troubleshooting.md @@ -0,0 +1,11 @@ +# Menu & Menu Drawer Troubleshooting + +If you're having problems with the menu or menu drawer (for example: doesn't open/close, won't display correctly on the homepage, mega menu layout not appearing), try these steps: + +1. Clear your browser cache and test in incognito mode. +2. Confirm that JavaScript is enabled and no third-party app disables menu features. +3. After theme upgrades, review header and menu settings: Mega menu, columns, cards, and vertical/horizontal layouts can reset to defaults. +4. If the issue only happens on the home page (but not other pages), save and republish your header configuration. A fresh theme install may be needed to troubleshoot further. +5. Still stuck? [Contact support](contact-support.md) with a description and screenshots. + +Paper/Keystone: Mega menus require specific column/card configuration. [Read our advanced menu guide](advanced-menu-layouts.md).