How duckhoa-uit/nf-shopify works
Project type and purpose
• Dawn (and this Northfinder Shopify theme) is a Shopify Online Store 2.0 theme.
• It’s essentially a front‑end theme project: Liquid templates rendered server‑side by Shopify, with progressive enhancement via CSS and JavaScript.
• Purpose: Provide merchants with a fast, maintainable, extensible storefront that follows Shopify’s HTML‑first and JS‑only‑as‑needed philosophy.
File structure
• Top‑level dirs
• assets/ – CSS, JS, images, fonts, constants, modules, tests
• layout/ – Liquid layout wrappers (theme.liquid, password.liquid)
• locales/ – translation JSON files and schemas
• sections/ – JSON/Liquid files for customizable theme sections
• snippets/ – small Liquid fragments included in templates/sections
• templates/ – page templates (JSON for Online Store 2.0, Liquid for gift_card)
• config/ – settings_data.json & schema.json defining Theme Editor controls
• docs/architecture – markdown docs including project_diagram.md
• Config & tooling
• shopify.theme.toml, tailwind.config.js, vitest.config.js, pnpm‐lock.yaml
• GitHub Actions workflows (.github/workflows/ci.yml,test.yml)
• VSCode settings, theme‑check rules, Prettier, .npmrc
Readme insights
• Emphasizes server‑rendered Liquid, progressive enhancement, no unnecessary polyfills
• Developer tools: Shopify CLI, Theme Check, Lighthouse CI via GitHub Actions
• CI checks: linting, tests, Lighthouse audits, theme validation
Key reminders
• Both build‑time (pnpm install, CLI dev, tests) and run‑time (Liquid render, CDN serve, JS enhancements).
• Don’t overthink—map each part of the file tree to a visual component, connect them logically, and annotate interactions clearly.