Version Migration for Findify Liquid Components

This guide outlines the steps to upgrade your Shopify theme to the latest version of Findify Liquid components while retaining your customizations.

1. Prepare Your Environment

To ensure a smooth migration:

• Set up Theme Kit: Use Shopify’s Theme Kit for seamless theme development. Getting Started with Theme Kit
• Install Git: Ensure Git is installed for version control. Git - Installing Git

2. Back Up Your Current Theme

Before migrating, back up your existing theme to safeguard your customizations:

1. Open your terminal.

2. Run the following commands to commit the current state of your theme:

   Bash

   git add *
   git rm --cached config.yml
   git commit -m "Backup current theme before Findify migration"
   
   

   Note: Exclude config.yml from version control as it contains sensitive environment-specific information.

3. Confirm the backup in the Source Control sidebar of Visual Studio Code. The only untracked file should be config.yml.

   

3. Download the Latest Findify Components

Findify versions follow the format YYYY-MM.RR:

• YYYY: Year of the release.
• MM: Month of the release (major updates occur quarterly: January, April, July, and October).
• RR: Release number within the quarter (e.g., 01, 02, 03, etc.).

1. Visit the Findify Liquid Components Repository.
2. Select the latest version.
3. Download and extract the ZIP file.

4. Update Your Theme

Integrate the updated Findify components into your Shopify theme while retaining customizations:

1. In Visual Studio Code, open your theme folder.

2. Drag and drop the updated files from the extracted ZIP into their respective theme directories:

   • Assets
   • Sections
   • Snippets

   Pro Tip: Overwrite existing files only if you haven't customized them.

   

5. Review and Merge Changes

1. Open the Source Control sidebar in Visual Studio Code.

   

2. Compare the newly added files against your current theme to identify changes:

   • Keep Customizations: If a file contains heavy customizations, create a separate snippet or isolate your UI logic to avoid overwriting.
   • Use Release Notes: Refer to the release notes on the Findify repository for detailed information on updates.

6. Test the Integration

Before publishing the updated theme:

• Preview your store in Shopify to verify that all Findify features are functioning as expected.
• Test heavily customized components to ensure they are still compatible with the new version.

7. Publish and Push Changes

Once satisfied with the updates:

1. If using Git, commit and push the changes to your repository:

   Bash

   git add *
   git commit -m "Upgrade to Findify Liquid Components [version]"
   git push
   
   

2. Merge changes into your live theme using Shopify CLI or the Shopify Admin interface.

By following this migration guide, you can safely upgrade to the latest Findify Liquid components while maintaining your store’s unique look and feel. If you encounter issues, refer to the release notes or contact [email protected] for assistance.