How scandiweb/satoshi-hyva works
Project type and purpose
• This is a Magento 2 full-stack extension plus frontend theme (“Satoshi” for Hyvä).
• On the backend it provides dozens of Magento modules (under app/code/Satoshi/*) that hook into Magento’s MVC, GraphQL, DI, and area-specific (frontend/adminhtml) systems.
• On the frontend it delivers a Hyvä theme (under app/design/frontend/Satoshi/Hyva) plus a modern TypeScript/Vite-powered SPA-style UI layer (under …/web/satoshi) that consumes Magento’s GraphQL/REST APIs for a fast, app-like UX.
File structure
• Top‐level “app/code/Satoshi” holds many Magento modules (Bundle, Catalog, CatalogGraphQl, Search, Checkout, Customer, Theme, UI, etc.). Each has its own etc/module.xml, di.xml, registration.php, plus controllers, blocks, models, viewmodels, GraphQL resolvers, patches, migrations, fixtures, etc.
• “app/design/frontend/Satoshi/Hyva” is the Hyvä theme: Magento layouts, PHTML templates, UI components, adminhtml pagebuilder definitions, static assets (CSS, JS, images), and a subfolder “web/satoshi” containing a full TypeScript/SPX app built with Vite.
• Configuration files: composer.json, package.json, readymage.yaml, plus Magento’s app/etc/config.php.
• Build tool configs: Vite, tailwind, postcss, pnpm/npm.
• The structure follows Magento’s modular MVC and DI pattern, and a decoupled frontend that talks to the backend over GraphQL/REST.
README for additional insights
• Satoshi is public-beta, extends Hyvä performance with Satoshi UX features (transitions, animations, dynamic rendering, instant add to cart, filtering/search, endless pagination).
• It integrates deeply with Magento’s checkout, cart, catalog, layered navigation, wishlist, etc., and provides GraphQL resolvers to feed the SPA layer.
• Developer guide and documentation link to deeper architectural details (pagebuilder integration, dynamic template mapping, GraphQL endpoints).