Skip to content

Hello World Section (sections/hello-world.liquid)

sections/hello-world.liquid is a simple welcome section that displays introductory content about Shopify theme development. It includes a welcome message, description text, an icon, and three highlight cards with links to Shopify documentation. The section serves as a starting point template for theme development.


Dependencies & Assets

TypeFiles / Components
CSSInline {% stylesheet %} block
Iconsicon-shoppy-x-ray.svg (via asset_url)
DataNo dynamic data dependencies
  • No JavaScript dependencies; the section is purely presentational.
  • No external CSS files; all styling lives inside the {% stylesheet %} block.
  • Content is static (hardcoded text); no section settings are used.

Markup Structure

liquid
<div class="welcome full-width">
  <div class="welcome-content">
    <div>
      <h1>Hello, World!</h1>
      <p class="welcome-description">
        The Skeleton theme is a minimal, carefully structured Shopify theme designed to help you quickly get started.
        Designed with modularity, maintainability, and Shopify's best practices in mind.
      </p>
      <p class="welcome-description">
        Themes shape the online store experience for merchants and their customers. Build fast, flexible themes at scale
        using Liquid, Shopify's theme templating language, along with HTML, CSS, JavaScript, and JSON.
      </p>
    </div>
    <div class="icon">
      <img src="{{ 'icon-shoppy-x-ray.svg' | asset_url }}" width="300" height="300">
    </div>
  </div>
</div>

<div class="highlights">
  <div class="highlight">
    <h3>Key Concepts</h3>
    <p class="highlight-description">...</p>
    <p>{{ 'Learn more about key concepts' | link_to: 'https://shopify.dev/docs/storefronts/themes/architecture' }}</p>
  </div>
  <!-- Two more highlight cards -->
</div>
  • Welcome section: Displays heading, description paragraphs, and an icon image.
  • Highlights section: Three-column grid (responsive, collapses to single column on mobile) with documentation links.
  • Static content: All text is hardcoded; no translation keys or dynamic content.

Welcome Content

liquid
<div class="welcome full-width">
  <div class="welcome-content">
    <div>
      <h1>Hello, World!</h1>
      <p class="welcome-description">...</p>
    </div>
    <div class="icon">
      <img src="{{ 'icon-shoppy-x-ray.svg' | asset_url }}" width="300" height="300">
    </div>
  </div>
</div>
  • Welcome message with two description paragraphs.
  • Icon image (300x300px) loaded via asset_url filter.
  • Content uses CSS Grid for layout (content in grid column 2).

Highlights

liquid
<div class="highlights">
  <div class="highlight">
    <h3>Key Concepts</h3>
    <p class="highlight-description">...</p>
    <p>{{ 'Learn more about key concepts' | link_to: 'https://shopify.dev/docs/storefronts/themes/architecture' }}</p>
  </div>
  <!-- Similar structure for "Liquid" and "Best Practices" cards -->
</div>
  • Three highlight cards with headings, descriptions, and external documentation links.
  • Links use Liquid's link_to filter to create anchor tags.
  • Responsive grid: 3 columns on desktop, 1 column on mobile (≤1100px).

Behavior

  • Purely presentational; there's no JavaScript.
  • All content is static (hardcoded text).
  • Responsive design handled via CSS media queries.
  • Links point to external Shopify documentation URLs.

Schema

json
{
  "name": "Hello World",
  "settings": [],
  "presets": [
    {
      "name": "Hello World Template",
      "category": "Demo"
    }
  ]
}

Section Settings

  • No settings defined; section has no customizable options.

Presets

  • Includes a preset named "Hello World Template" in the "Demo" category for easy section addition.

Implementation Notes

  1. Static content: All text content is hardcoded in English. Consider using translation filters (t:) if localization is needed.

  2. Icon dependency: Requires icon-shoppy-x-ray.svg to exist in assets/ directory. Missing icon will result in broken image.

  3. Full-width class: Section uses full-width class. Ensure this class is defined in the theme's CSS and handles full-width layout appropriately.

  4. CSS Grid dependency: Welcome content uses CSS Grid with grid-column: 2, which assumes a grid structure defined elsewhere (likely via --content-grid variable or similar). Ensure the grid is properly configured.

  5. Responsive breakpoint: Highlights grid collapses to single column at 1100px. Ensure this aligns with the theme's global breakpoint strategy.

  6. External links: All highlight cards link to external Shopify documentation. Links use the link_to filter which generates proper anchor tags.

  7. No dynamic values: Section has no settings, so there are no dynamic CSS values or conditional rendering based on merchant configuration.

  8. Placeholder/template purpose: This section appears to be a starter template or example. Consider whether it should remain in production themes or be removed after initial setup.

  9. Hardcoded styling: Colors, spacing, and layout are hardcoded in the stylesheet block. Consider making key values configurable via settings if this section will be used in production.

  10. Accessibility: Ensure proper heading hierarchy and semantic HTML. The section uses <h1> for the main heading and <h3> for highlight cards, which is appropriate.