Prerequisites

Before starting the installation, you'll need to add authentication credentials for both Hyva and Magento repositories.

Authentication Setup

Due to credentials requirements, you'll need to either:

• Create an auth.json file at the root of your project, or
• Set in COMPOSER_AUTH environment variable

Example auth.json file:

{
  "http-basic": {
    "hyva-themes.repo.packagist.com": {
      "username": "XX",
      "password": "XX"
    },
    "repo.magento.com": {
      "username": "XX",
      "password": "XX"
    }
  }
}

Replace XX with your actual credentials for both repositories.

Installation Steps

<aside> 💡

Note: Satoshi uses Create Magento App (CMA), which enables fast and simple installation of Magento environments. CMA is a toolset that simplifies Magento development by automating environment setup and configuration. For more details, see the CMA documentation

</aside>

1. Clone the Satoshi repository:

git clone [email protected]:scandiweb/satoshi-hyva.git satoshi

1. Install dependencies and start the application:

cd satoshi
npm install
npm run start

After successful installation this will automatically open Satoshi in your browser.

1. Build the frontend assets:

cd app/design/frontend/Satoshi/Hyva/web/satoshi
npm install
npm run dev

This will compile both Tailwind CSS and Alpine.js code, continuously watching for changes and rebuilding the frontend assets automatically.

The npm run dev command will keep running, monitoring your frontend files, and recompiling them whenever changes are detected.