ChainLine Performance
Merchant guide · Version 2.0.0 · 5 November 2026
Install the Shopify theme
- Keep the existing theme. Upload ChainLine-v2.0.0-Performance.zip in Online Store → Themes → Add theme → Upload ZIP.
- Open the new draft in the theme editor. Do not upload the documentation or demo package as a theme.
- This is a major visual update. A fresh ZIP does not automatically inherit the previous draft’s editor settings or custom code. Reapply your logo, menus, app blocks, embeds and store content.
- Keep the store password protected while setting up demonstration products. Use the draft’s preview link for review.
The installed theme contains the approved Performance layout. The prototype’s review bar and Brand studio are replaced by Shopify’s editor controls. Products, collections, shipping, policies and payment configuration belong to the store.
Reproduce the four-product concept
- Deploy the updated IdeaSmart support website ZIP to the existing Netlify site first. Extract the ZIP and deploy the folder containing index.html. Keep Netlify form detection enabled. Confirm /chainline-demo/demo-cassette.webp opens directly as an image before importing the CSV.
- Extract ChainLine-v2.0.0-Demo-Setup.zip. In the partner development store, import products.csv through Products → Import. Review all four rows before confirming. Leave overwrite-existing-products unchecked. The handles start with chainline-demo- to reduce collisions. Prices are demonstration amounts intended for a KES demo store; Shopify interprets numbers in your store’s base currency.
- The import requests a manual collection named ChainLine Featured. Confirm its handle is chainline-featured, includes exactly the four new demo products and is available to Online Store. Sort manually: Performance Cassette, Disc Brake Rotor, Platform Pedal Set, Workshop Multi-tool. In the theme editor choose this collection in Featured products.
- Create or assign Brakes, Drivetrain, Wheels & tyres and Workshop tools collections. Link them in Shop by system, Collection tabs and Fit desk. For automatic collections use tags system-brakes, system-drivetrain, system-wheels and system-tools. The sample has no wheel product: link that card to your full catalog or add a genuine wheel product with permitted imagery. Configure a real navigation menu when needed.
The CSV creates active products published to Online Store for the password-protected demo. These are conceptual items, not fulfilment-ready stock. Do not use them in a public trading store. The CSV does not change payment settings, install an app or place an order. If hosted images do not load, use products-manual-images.csv instead, then upload the corresponding four images directly on the product pages. Do not import both files as separate batches unless intentionally updating the same four demo handles.
Brand and theme settings
Brand controls the logo, wordmark, tagline, logo width, favicon and social sharing image. A logo upload replaces the chain mark; clear the wordmark or disable Show store name in Header if the uploaded artwork already includes text.
Colors controls the page, surfaces, main and muted text, accent, highlight, success color and border visibility. Typography offers Technical (Barlow Condensed + Space Grotesk), Editorial (Space Grotesk) and Custom (Shopify font pickers). Font pickers apply when Custom is selected. Body and heading scales supplement section sizes. Layout controls page width, section spacing and grid gap. Buttons controls shape and height. Product cards controls vendor/type, compare-at price, image fit and image background. Use white and Show whole image to preserve the approved imagery.
Demo imagery enables bundled AI concept hero/editorial images where no upload exists. It does not upload product media to Shopify. Background grids remain off by default. Check contrast and long headings after rebranding; image artwork retains its own colors and background.
Home page sections
The default order is Performance hero, Shop by system with component strip, Featured products, Precision story, Field notes and Call to action. Each is editable, reorderable and removable.
- Performance hero: two heading lines, supporting text, labels, primary destination, fit desk button, uploaded image, hero height and hotspots. The three stacked labels remain at the bottom right. Uploaded hero images replace the bundled illustration.
- Shop by system: four blocks with image, bundled illustration, title, description and collection/link. Images from the block or collection take priority. An unassigned link falls back to the full catalog.
- Featured products: actual selected collection and product count. If no collection is selected, the theme tries chainline-featured, then the catalog. No products are created by uploading a theme.
- Precision story: image, caption, three heading parts, text, fit desk button and field notes link.
- Field notes: blocks can link to a Shopify article or custom URL. Without a destination they open the selected system’s fit checklist. Create a Field notes page with the supplied page.field-notes template if you want a dedicated guide; otherwise navigation goes to the homepage section.
- Call to action: Wrong part? Avoid that, text and button. Open fit desk can be disabled to use the configured URL.
Legacy hero, compatibility, workshop, rich text, collection, trust and other supplied sections remain available for alternative pages. They use the updated color and typography settings but are not the default concept arrangement.
Product pages and product-specific features
Product title, vendor, type, price, inventory, options, descriptions and gallery media come from Shopify Products. Product blocks preserve native product forms, variant selection, selling plans, gift recipient inputs, app blocks, pickup availability and optional accelerated checkout. The default concept keeps accelerated checkout off; it can be enabled in Main product.
Whole images use a white media panel. Main product → Image fit changes contain/cover separately from product cards. Media position, width, adapt/fixed height, thumbnails, sticky media, videos and zoom remain configurable. Zoom has +, − and Fit controls. Fit shows the complete image; enlarged views scroll/pan inside the canvas.
The optional metafields below let each product have its own content without creating a template for every item. In Shopify Settings → Custom data/Metafields and metaobjects → Products, add definitions using these exact keys and types. Then fill them on each product. Storefront labels can vary with Shopify admin updates.
| Name | Namespace and key | Type | Display |
|---|---|---|---|
| Short description | custom.short_description | Single line text | Short description metafield block, under title |
| Features | custom.features | Single line text → List of values | Product features metafield block; empty lists are hidden |
| Fit notes | custom.fit_notes | Multi-line text | Fit notes tab and comparison; one check per line |
| Specifications | custom.specifications | Rich text | Details tab; blank content is hidden |
The default product template already includes the Short description, Product features and Product information tabs blocks. Short description, features and specifications render only when populated. Fit notes uses the product metafield when present, with an editable generic fallback. Put one fit check per line so comparison can show individual checks. Shared delivery/returns content stays in accordion blocks; replace demonstration policy wording with the store’s actual terms. For a very different block arrangement, create another product template and assign it to the relevant products.
The demo CSV deliberately does not depend on pre-created metafields. Optional product-content.json and the setup guide contain the four short descriptions and fit checks for copying into the fields. Only add feature benefits and technical specifications you can substantiate; AI illustrations do not establish real materials, dimensions or performance.
Fit desk and comparison
Fit desk is an editable global section at the end of the theme editor’s section list. Edit its introduction, disclaimer, maintenance note and system blocks. Each system has a title, key, checklist (one item per line) and collection destination. Keep one block per system key for the hero shortcuts. It guides system → task → checklist and does not calculate or guarantee compatibility.
Compare buttons on real product cards and product pages collect up to two items. The tray opens a comparison with each product’s title, photo, type, base price, fit notes and product link. It uses current store data at selection, not a hardcoded demo catalog. Product prices can change; confirm the chosen variant on its product page. The comparison is retained in session storage for the current language and currency; Clear removes it. It makes no compatibility determination and has no cart or tracking requests.
Header, footer and navigation
Header supports a selected Shopify menu with three levels, search, account access, drawer/page cart and sticky behavior on desktop/mobile. With no menu selected, the concept navigation is Components, Systems, Fit desk and Field notes. System shortcuts use standard collection handles when those exist and the full catalog otherwise.
Footer supports custom menu, quick link, fit/field note, policy and text blocks, social links, newsletter signup, localization and payment icons. The default has newsletter off to match the concept; enable it if desired. Only configured country/language options and store policies appear. The theme does not create legal policies or merchant service promises.
Collections, filters and search
Collection pages render real Shopify products with native pagination and sorting. Add Collection tab blocks and select the relevant collections. The collection description overrides fallback introduction text. Filters come from Shopify’s configured storefront filters, often managed in Search & Discovery. The theme cannot invent filter values for your catalog. The sidebar search submits a store product search; it is not limited to the current collection. Search drawer uses the existing predictive-search implementation.
Cart, checkout, apps and tracking
Cart operations remain in the original theme.js cart implementation: one in-flight submission per form, serialized drawer mutations, section refresh and native cart recovery. Theme code does not send a second add request to recover a failed section render. Add, +, − and remove controls use real Shopify endpoints once installed. An app that already prevented the product submit is respected.
Enable apps through Shopify app blocks and app embeds. Shopify’s content_for_header output is preserved. Configure analytics and customer event pixels in Shopify/apps; this theme adds no manual advertising or purchase pixel. A theme cannot guarantee that separately installed apps do not duplicate events. Check your actual pixel setup and one test order’s event results before launch. Do not repeat a checkout to verify an uncertain order; inspect Shopify Orders first.
Other pages, accessibility and languages
Existing cart, contact, article, blog, search, password, gift card and classic customer templates are preserved. Customer account rendering depends on the store’s account type. Contact/newsletter forms use Shopify. Create actual pages and assign templates as required. The new Field notes template provides editable guidance blocks; review all advice before publishing.
The theme includes a skip link, visible focus states, native disclosures/dialogs and keyboard tabs. Overview/Fit notes/Details supports arrow, Home and End keys. With JavaScript disabled, native forms and product information remain available; advanced drawer/zoom/comparison utilities require JavaScript. The added UI strings live in locales/en.default.json; translate them and section content for your supported languages. Follow your normal language QA before launch.
Validation and remaining Shopify acceptance tests
This v2.0.0 candidate passed Shopify Theme Check with zero reported issues, JavaScript syntax checks and the cart submit regression suite. The suite covers rapid/repeated submits, app-prevented submits, network/stock failures, section render failure, missing drawer, invalid/disabled forms and page-cart fallback.
Local browser checks use rendered Liquid with fixture products and a simulated Shopify cart API. Desktop add, increase, decrease and removal reached the expected quantities and subtotals. Fit desk and comparison were exercised. Responsive frames cover compact phone layouts; zoom was inspected in desktop and phone-width frames. These checks are not equivalent to Shopify hosting, physical devices or a real payment transaction.
- Upload the draft and confirm the four images, collection order, settings and links. Change accent, background, type style and spacing in the editor and verify both preview and a saved storefront tab. Switch Custom fonts on before testing the font pickers.
- Test available, unavailable and multi-option products, linked variant images, quantities and media. Test drawer add/+/-/remove, cart page, discounts, locale/currency and app-injected blocks with your actual apps.
- Test a development-store order using Shopify’s supported test payment setup. Confirm exactly one order and inspect configured customer event/pixel behavior. No purchase event has been certified by this local build.
- Test on a physical iPhone/Android and desktop Safari/Chrome. Run current performance and accessibility audits on the actual demo catalog. Validate keyboard, screen reader, translated strings and long content.
- Verify shipping, returns, tax, payment, stock, policy, support form delivery and documentation. Review the current Shopify Theme Store requirements before submission. Theme Check alone is not approval or submission readiness.
Troubleshooting and support
- Old storefront: confirm the new draft name in the preview bar. The normal store domain generally serves the published theme.
- Old products: select ChainLine Featured. A fresh theme does not remove existing products. Archive obsolete demo items rather than deleting actual store stock.
- Images missing: confirm the Netlify image URL is public, then check the Shopify product’s media. Theme assets do not automatically become product gallery media.
- Color/font unchanged: save the draft settings, check the correct preview, disable conflicting app/custom CSS, and select Custom before using font pickers. Shared dynamic theme settings load after theme CSS.
- Blank features: verify exact namespace/key and field type, fill the product value, and ensure the Product features block exists on the assigned template.
- Cart error: check variant availability, quantity, actual app interactions and the visible message. If an add succeeded but refresh failed, inspect the cart before retrying.
- Support form: enable Netlify form detection and redeploy this folder, configure email notifications to ideasmartkenya@gmail.com, then submit a harmless test yourself and verify receipt. Form delivery has not been tested by this build.
Theme support: support form or ideasmartkenya@gmail.com. Include theme version, draft preview URL, page, browser/device and steps. Never send passwords, API tokens or customer payment details.