Installing Satoshi theme is a straightforward process using Composer. This guide will walk you through the necessary setup and the installation steps.

Prerequisites

Before you begin, please ensure that your environment meets the following requirements:

• Node.js: Version 18.0.0 or higher
• PHP: Version 8.1 or higher
• Magento 2 Project: An up and running Magento 2 project.
• Valid Hyvä License: An active license for the Hyvä theme, as Satoshi is a based on Hyvä.

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": "YOUR_HYVA_USERNAME",
      "password": "YOUR_HYVA_PASSWORD_OR_TOKEN"
    },
    "repo.magento.com": {
      "username": "YOUR_MAGENTO_PUBLIC_KEY",
      "password": "YOUR_MAGENTO_PRIVATE_KEY"
    }
  }
}

In your Magento project's root composer.json file, make sure you have added the Hyvä Private Packagist URL to the repositories section.

"repositories": {
    "private-packagist": {
        "type": "composer",
        "url": "ENTER_YOUR_HYVÄ_PRIVATE_PACKAGIST_KEY_HERE"
    }
}

Installation Steps

With the authentication configured, you can now install the theme with two simple commands.

1. Require the Package: Open your terminal, navigate to your Magento project's root directory, and run the following command to add the theme to your project:

   composer require scandiweb/satoshi
   

2. Enable the Theme: Next, run the Magento setup upgrade command to register the theme and apply necessary database changes:

   bin/magento setup:upgrade
   

3. Activate the Theme

   The theme is now installed. The final step is to activate it from your Magento Admin Panel.

   1. Navigate to Content → Design → Configuration.
   2. Find the store view you wish to apply the theme to and Edit to select "Satoshi Theme".
   3. Clear the Magento cache by running bin/magento cache:clean in your terminal or through the admin panel.