@scandipwa/magento-scripts 1.13.5-alpha.1 → 1.14.0

package/lib/config/versions/magento-2.3.0.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.2.33',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.1.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.2.33',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.2-p2.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.2.33',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.2.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.2.33',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.3-p1.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.3.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.4-p2.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.4.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.5-p1.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.5-p2.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.5.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.6-p1.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/config/versions/magento-2.3.6.js

@@ -8,7 +8,9 @@ module.exports = ({ templateDir } = {}) => ({
             version: '7.3.28',
             configTemplate: path.join(templateDir || '', 'php.template.ini'),
             extensions: {
-                gd: {},
+                gd: {
+                    macosOptions: '--with-zlib-dir=$(brew --prefix zlib) --with-freetype-dir=$(brew --prefix freetype)'
+                },
                 intl: {},
                 zlib: {},
                 openssl: {},

package/lib/tasks/composer/index.js

@@ -17,7 +17,7 @@ const getComposerVersion = async ({ composer, php }) => {
 
     const composerVersion = safeRegexExtract({
         string: composerVersionOutput,
-        regex: /(\d+\.\d+\.\d+)/i,
+        regex: /composer.+(\d+\.\d+\.\d+)/i,
         onNoMatch: () => {
             throw new Error(`
 No composer version found in composer version output!\n\n${composerVersionOutput}

package/lib/tasks/php/compile-options.js

@@ -74,7 +74,8 @@ const compileOptions = {
             CPATH: '$CPATH:$(brew --prefix openssl@1.1)/include',
             CXX: 'g++ -DTRUE=1 -DFALSE=0',
             CC: 'gcc -DTRUE=1 -DFALSE=0',
-            LDFLAGS: '$(brew --prefix openssl@1.1)/lib/libssl.dylib $(brew --prefix openssl@1.1)/lib/libcrypto.dylib'
+            LDFLAGS: '$(brew --prefix openssl@1.1)/lib/libssl.dylib $(brew --prefix openssl@1.1)/lib/libcrypto.dylib',
+            CFLAGS: '-Wno-implicit-function-declaration' // https://github.com/phpbrew/phpbrew/issues/1222
         }
     }
 };

package/lib/tasks/php/compile.js

@@ -16,7 +16,7 @@ const compile = () => ({
                 platformCompileOptions.extraOptions.push('--with-libdir=lib64');
             }
         }
-        const commandEnv = Object.entries(platformCompileOptions.env || {}).map(([key, value]) => `${key}="${value}"`).join(' && ');
+        const commandEnv = Object.entries(platformCompileOptions.env || {}).map(([key, value]) => `export ${key}="${value}"`).join(' && ');
         const phpCompileCommand = `${commandEnv ? `${commandEnv} && ` : ''} \
         phpbrew install -j ${platformCompileOptions.cpuCount} ${php.version} ${platformCompileOptions.variants.join(' ')} \
         -- ${platformCompileOptions.extraOptions.join(' ')}`;

package/lib/tasks/requirements/composer.js

@@ -1,36 +1,228 @@
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
 const logger = require('@scandipwa/scandipwa-dev-utils/logger');
+const pathExists = require('../../util/path-exists');
+
+const authJsonPath = path.join(process.cwd(), 'auth.json');
+const shellName = process.env.SHELL.split('/').pop();
+const shellConfigFileName = `.${shellName}rc`;
+const shellConfigFilePath = path.join(os.homedir(), shellConfigFileName);
+
+const pasteKeybinding = process.platform === 'darwin' ? 'CMD + V' : 'CTRL + SHIFT + V';
+
+const MISSING_COMPOSER_AUTH_ENV = 'missing composer auth environment variable';
+const MISSING_AUTH_JSON = 'missing auth.json file';
 
 /**
  * @type {() => import('listr2').ListrTask<import('../../../typings/context').ListrContext>}
  */
-const checkComposer = () => ({
-    title: 'Checking Composer environmental variables',
-    task: () => {
-        try {
-            if (!process.env.COMPOSER_AUTH) {
-                throw new Error(`Environmental variable ${ logger.style.misc('COMPOSER_AUTH') } is not set.`);
+const configureComposerCredentials = () => ({
+    title: 'Configuring Composer Credentials',
+    task: async (ctx, task) => {
+        const configureLocation = await task.prompt({
+            type: 'Select',
+            message: `We didn't find Composer credentials in your ${ logger.style.misc('$COMPOSER_AUTH') } environment variable or in your ${ logger.style.file('./auth.json') } file.
+
+Those credentials are required to install Magento.
+
+Where do you want to store them?`,
+            choices: [
+                {
+                    message: `Inside my projects directory in ${ logger.style.file('auth.json') } file [${ logger.style.misc('Recommended') }]`,
+                    name: 'auth.json'
+                },
+                {
+                    message: `Inside my shells configuration file located in users home directory ${ logger.style.file(shellConfigFileName) } [${ logger.style.misc('Shared credentials, not recommended') }] `,
+                    name: 'shell'
+                }
+            ]
+        });
+
+        const usernameCredentials = await task.prompt({
+            type: 'Input',
+            message: `Please enter your username key.
+
+You can obtain this key from Magento Marketplace
+
+1. Go to ${ logger.style.link('https://marketplace.magento.com/customer/accessKeys/') }
+2. Use created Access Keypair or click ${ logger.style.misc('Generate Access Keypair') } to generate new Access Keypair
+3. Click ${ logger.style.misc('Copy') } on ${ logger.style.misc('Public key') } and paste it here (${logger.style.misc(pasteKeybinding)})
+
+${ logger.style.misc('Username') } (${ logger.style.misc('Public key') }):`,
+            required: true,
+            validate: (value) => {
+                if (value.trim() === '') {
+                    return 'Username must not be empty';
+                }
+
+                return true;
             }
+        });
 
-            let magento;
+        const passwordCredentials = await task.prompt({
+            type: 'Input',
+            message: `Please enter your password key.
 
-            try {
-                magento = JSON.parse(process.env.COMPOSER_AUTH);
-            } catch (e) {
-                throw new Error(`Environmental variable ${ logger.style.misc('COMPOSER_AUTH') } is not valid JSON.`);
+You can obtain this key from Magento Marketplace
+
+1. Go to ${ logger.style.link('https://marketplace.magento.com/customer/accessKeys/') }
+2. Use created Access Keypair or click ${ logger.style.misc('Generate Access Keypair') } to generate new Access Keypair
+3. Click ${ logger.style.misc('Copy') } on ${ logger.style.misc('Private key') } and paste it here (${logger.style.misc(pasteKeybinding)})
+
+${ logger.style.comment('Make sure to use Private key from the same Keypair as your Public key!')}
+
+${ logger.style.misc('Password') } (${ logger.style.misc('Private key') }):`,
+            required: true,
+            validate: (value) => {
+                if (value.trim() === '') {
+                    return 'Password must not be empty';
+                }
+
+                return true;
             }
+        });
 
-            if (!magento || !magento['http-basic'] || !magento['http-basic']['repo.magento.com']) {
-                throw new Error(`Environmental variable ${ logger.style.misc('COMPOSER_AUTH') } does not contain the ${ logger.style.misc('repo.magento.com') } field.`);
+        const authContent = {
+            'http-basic': {
+                'repo.magento.com': {
+                    username: usernameCredentials,
+                    password: passwordCredentials
+                }
             }
-        } catch (e) {
+        };
+
+        const authJsonContent = JSON.stringify(authContent, null, 4);
+        const authEnvContent = `export COMPOSER_AUTH='${JSON.stringify(authContent)}'`;
+
+        process.env.COMPOSER_AUTH = authJsonContent;
+
+        if (configureLocation === 'auth.json') {
+            await fs.promises.writeFile(authJsonPath, authJsonContent, 'utf-8');
+            return;
+        }
+
+        switch (shellName) {
+        case 'bash':
+        case 'zsh': {
+            await fs.promises.appendFile(
+                path.join(os.homedir(), shellConfigFileName),
+                `\n${authEnvContent}\n`
+            );
+            break;
+        }
+        default: {
             throw new Error(
-                `To generate Composer credentials login into Magento Marketplace and follow the official guide.
-        The guide is found here: ${ logger.style.link('https://devdocs.magento.com/guides/v2.3/install-gde/prereq/connect-auth.html') }
-        Then, insert obtained credentials into this command, and execute:
-        ${logger.style.code('export COMPOSER_AUTH=\'{"http-basic":{"repo.magento.com": {"username": "<PUBLIC KEY FROM MAGENTO MARKETPLACE>", "password": "<PRIVATE KEY FROM MAGENTO MARKETPLACE>"}}}\'')}\n\n${e}`
+                `Unfortunately we cannot automatically add credentials for your shell ${process.env.SHELL}!
+
+You will need to that manually!
+
+Add following string to your shell configuration file: ${ logger.style.code()}`
             );
         }
+        }
+
+        await task.prompt({
+            type: 'Confirm',
+            message: `Before we continue with installation...
+
+You selected to add your Magento credentials to your shell environment, you should know that shell configuration does not update automatically.
+
+To update it you can either restart your existing shell or run the following command to update the configuration temporarily: ${ logger.style.code('source <path/to/config/file>')}
+
+Press ${ logger.style.misc('Y') } to continue`
+        });
+    }
+});
+
+/**
+ * @type {() => import('listr2').ListrTask<import('../../../typings/context').ListrContext>}
+ */
+const checkComposerCredentials = () => ({
+    title: 'Checking Composer credentials',
+    task: async (ctx, task) => {
+        const problems = new Map();
+        if (!process.env.COMPOSER_AUTH) {
+            problems.set(MISSING_COMPOSER_AUTH_ENV, true);
+        }
+
+        if (!await pathExists(authJsonPath)) {
+            problems.set(MISSING_AUTH_JSON, true);
+        }
+
+        if (problems.has(MISSING_COMPOSER_AUTH_ENV) && problems.has(MISSING_AUTH_JSON)) {
+            let doConfigure = true;
+            if (await pathExists(shellConfigFilePath)) {
+                const rcFileContent = await fs.promises.readFile(shellConfigFilePath, 'utf-8');
+
+                const lines = rcFileContent.split('\n');
+                const composerAuthInRcFile = lines.some((line) => line.startsWith('export COMPOSER_AUTH='));
+
+                if (composerAuthInRcFile) {
+                    doConfigure = false;
+                    const loadCredentialsFrom = await task.prompt({
+                        type: 'Confirm',
+                        message: `We detected that you have ${ logger.style.misc('COMPOSER_AUTH') } environment variable set in ${ logger.style.file(shellConfigFilePath) } file,
+but we do not see this variable inside ${ logger.style.code('magento-scripts') } process.
+
+${ logger.style.misc('! Don\'t forget to reload your shell after process is finished !') }
+
+Would you like to load them now?`
+                    });
+
+                    if (loadCredentialsFrom) {
+                        const credentialsLine = lines.find((line) => line.startsWith('export COMPOSER_AUTH='));
+                        process.env.COMPOSER_AUTH = credentialsLine.replace('export COMPOSER_AUTH=', '').replace(/'/ig, '').trim();
+                        problems.delete(MISSING_COMPOSER_AUTH_ENV);
+                    }
+                }
+            }
+
+            if (doConfigure) {
+                return task.newListr(
+                    configureComposerCredentials()
+                );
+            }
+        }
+
+        let composerAuthContent;
+
+        if (!problems.has(MISSING_AUTH_JSON)) {
+            try {
+                const composerAuthFileContent = await fs.promises.readFile(authJsonPath, 'utf-8');
+
+                composerAuthContent = JSON.parse(composerAuthFileContent);
+
+                process.env.COMPOSER_AUTH = composerAuthFileContent;
+            } catch (e) {
+                throw new Error(
+                    `We found an error in your ${ logger.style.file('./auth.json') } file.
+
+Make sure that this file contains a valid JSON!
+
+You can try linting your file here: ${ logger.style.link('https://jsonformatter.curiousconcept.com/') }
+
+Error message that we got: ${e}`
+                );
+            }
+        }
+
+        if (!problems.has(MISSING_COMPOSER_AUTH_ENV) && !composerAuthContent) {
+            try {
+                composerAuthContent = JSON.parse(process.env.COMPOSER_AUTH);
+            } catch (e) {
+                throw new Error(
+                    `We found an error in your ${ logger.style.misc('$COMPOSER_AUTH') } environment variable.
+
+Make sure that this variable contains a valid JSON!
+
+You can try linting your variable here: ${ logger.style.link('https://jsonformatter.curiousconcept.com/') }
+
+Error message that we got: ${e}`
+                );
+            }
+        }
     }
 });
 
-module.exports = checkComposer;
+module.exports = checkComposerCredentials;

package/lib/tasks/requirements/index.js

@@ -4,7 +4,6 @@ const checkComposer = require('./composer');
 const checkDocker = require('./docker');
 const checkNodeVersion = require('./node-version');
 const checkPHPVersion = require('./php-version');
-const localAuthJson = require('../composer/local-auth-json');
 
 /**
  * @type {() => import('listr2').ListrTask<import('../../../typings/context').ListrContext>}
@@ -21,7 +20,7 @@ const checkRequirements = () => ({
         // check the Docker installation
         checkDocker(),
         // check for COMPOSER_AUTH or auth.json
-        localAuthJson(),
+        // localAuthJson(),
         checkComposer(),
         // check for Node.js version
         checkNodeVersion()

package/package.json

@@ -3,7 +3,7 @@
     "description": "Scripts and configuration used by CMA.",
     "homepage": "https://docs.create-magento-app.com/",
     "repository": "github:scandipwa/create-magento-app",
-    "version": "1.13.5-alpha.1",
+    "version": "1.14.0",
     "main": "./index.js",
     "types": "./typings/index.d.ts",
     "license": "OSL-3.0",
@@ -41,5 +41,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "e00e8d06964b4a7fc5a0095ea510fc26a06520a8"
+    "gitHead": "60c7a2bacde24256dcb2d17128e41c0b371987a7"
 }

package/readme.md

@@ -1,150 +1,80 @@
 # magento-scripts
 
-This package contains scripts and configuration used by Create Magento App by [Create Magento App](https://github.com/scandipwa/create-magento-app).
+This package contains scripts and configuration used by [Create Magento App](https://github.com/scandipwa/create-magento-app).
 
 ## Overview
 
 What this package does:
-- Compiles correct php with all necessary extensions to run Magento on your system.
-- Organize services required to run Magento on your system, such as Nginx, Redis, MySQL and Elasticsearch, in docker containers with forwarded ports to host system.
+- Compiles correct PHP version with all necessary extensions to run Magento on your system.
+- Organize services required to run Magento on your system, such as Nginx, Redis, MySQL and Elasticsearch in Docker containers with forwarded ports to host system.
 - Allows you to run multiple M2 projects simultaneously on the same machine without ports/files/context overlapping.
 
+## Requirements
+
+### Linux Requirements
+
+Dependency list and installation guide is available in our [documentation for installation on Linux](https://docs.create-magento-app.com/getting-started/prerequisites/installation-on-linux)!
+
+### MacOS Requirements
+
+Dependency list and installation guide is available in our [documentation for installation on Mac](https://docs.create-magento-app.com/getting-started/prerequisites/installation-on-macos)!
+
+### Windows Requirements
+
+Dependency list and installation guide is available in our [documentation for installation on Windows](https://docs.create-magento-app.com/getting-started/prerequisites/windows-requirements)!
+
+> If you miss a requirement CMA will tell you and will give instructions or even provide a one click fix!
+
 ## Usage
 
-```bash
-> npx create-magento-app <folder name>
-> cd <folder name>
-> yarn/npm run start
-```
+### Start the App
 
-To use commands such as `composer`, `magento` and `php` with correct version run command:
 ```bash
-> yarn/npm cli
-```
-This will open bash with correct aliases to `php`, `magento` and `composer`.
+# Create an App
+npx create-magento-app <folder name>
 
-To open logs use command `logs` with one of the scopes: `redis`, `mysql`, `elasticsearch`, `nginx` or `magento`.
-```bash
-> yarn/npm run logs nginx
-> // nginx logs
+cd <folder name>
+
+# Run it with yarn
+yarn start
+
+# Or with npm
+npm run start
 ```
 
-> NOTE: you can use shortcuts for logs! Like `yarn logs m` will show `mysql` logs, `yarn logs ma` will show `magento` logs and e.t.c.
+> Documentation for `start` command is available [here](https://docs.create-magento-app.com/getting-started/available-commands/start).
 
-## Requirements
+### Access Application CLI
 
-- [Docker](https://docs.docker.com/get-docker/) ^19
-- [phpbrew](https://github.com/phpbrew/phpbrew) ^1.25
-
-For Mac
-- MacOS 10.5 and newer
-- Xcode 11 and newer You can find it.
-- [Homebrew](https://brew.sh/)
-
-## Dependencies
-
-### Ubuntu
-
-```sh
-apt-get install \
-    libcurl4-openssl-dev \
-    libonig-dev \
-    libjpeg-dev \
-    libjpeg8-dev \
-    libjpeg-turbo8-dev \
-    libpng-dev \
-    libicu-dev \
-    libfreetype6-dev \
-    libzip-dev \
-    libssl-dev \
-    build-essential \
-    libbz2-dev \
-    libreadline-dev \
-    libsqlite3-dev \
-    libssl-dev \
-    libxml2-dev \
-    libxslt-dev \
-    libonig-dev \
-    php-cli \
-    php-bz2 \
-    pkg-config \
-    autoconf
+To access Magento CLI, Composer and PHP use `cli` command:
+```bash
+# With yarn
+yarn cli
+
+# Or npm
+npm run cli
 ```
 
-### Mint Linux
+This will a new instance of Bash with aliases for PHP, Composer and Magento used in Create Magento App project.
 
-```
-apt-get install \
-    libjpeg-dev \
-    libjpeg8-dev \
-    libjpeg-turbo8-dev \
-    libpng-dev \
-    libicu-dev \
-    libfreetype6-dev \
-    libzip-dev \
-    libssl-dev \
-    build-essential \
-    libbz2-dev \
-    libreadline-dev \
-    libsqlite3-dev \
-    libssl-dev \
-    libxml2-dev \
-    libxslt-dev \
-    libonig-dev \
-    php-cli \
-    php-bz2 \
-    pkg-config \
-    autoconf \
-    libcurl4-openssl-dev 
-```
+> Documentation for `cli` command is available [here](https://docs.create-magento-app.com/getting-started/available-commands/cli).
 
-### CentsOS / Fedora
-```sh
-yum install --enablerepo=PowerTools openssl-devel \
-    libjpeg-turbo-devel \
-    libpng-devel \
-    gd-devel \
-    libicu libicu-devel \
-    libzip-devel \
-    libtool-ltdl-devel \
-    oniguruma-devel
-```
+### Access Application Logs
 
-### Arch
-```sh
-pamac install freetype2 \
-    openssl \
-    oniguruma \
-    libxslt \
-    bzip2 \
-    libjpeg-turbo \
-    libpng \
-    icu \
-    libxml2 \
-    autoconf \
-    libzip \
-    sqlite \
-    readline \
-    perl
-```
+To open logs use command `logs` with one of the scopes: `redis`, `mysql`, `elasticsearch`, `nginx` or `magento`.
+```bash
+# With yarn
+yarn logs nginx
 
-### MacOS
+# Or npm
+npm run logs nginx
 
-```sh
-sudo xcode-select -switch /Applications/Xcode.app
-```
-```sh
-brew install zlib \
-    bzip2 \
-    libiconv \
-    curl \
-    libpng \
-    gd \
-    freetype \
-    oniguruma \
-    icu4c \
-    libzip
+> ... nginx logs
 ```
 
-Additional libraries:  
-- Installed PHP with json extension.  
+> NOTE: you can also use name matching for logs! Like `yarn logs m` will show `mysql` logs, `yarn logs ma` will show `magento` logs and e.t.c.  
+Read more about this [here](https://docs.create-magento-app.com/getting-started/available-commands/logs#usage-example).
+
+---
+
+CMA contains even more useful commands like [checking application status](https://docs.create-magento-app.com/getting-started/available-commands/status), [executing commands in Docker containers](https://docs.create-magento-app.com/getting-started/available-commands/exec), [linking a theme](https://docs.create-magento-app.com/getting-started/available-commands/link) and [importing database](https://docs.create-magento-app.com/getting-started/available-commands/import-db)!