Skip to content
This repository has been archived by the owner on Jul 19, 2021. It is now read-only.

Latest commit

 

History

History
73 lines (46 loc) · 3.03 KB

README.md

File metadata and controls

73 lines (46 loc) · 3.03 KB

@shopify/slate-env

Manages the environment variables which are needed by Slate to interact with Shopify servers. Can create and run .env files used to store Slate environment variables for development.

By default, Slate will look for a .env file with environment variables.

Alternatively, users can specify --env with slate-tools scripts to use associated .env.{env} file. For example:

$ slate-tools start --env=production

will look for a .env.production file.

Default .env file format

# The myshopify.com URL to your Shopify store
SLATE_STORE=

# The API password generated from a Private App
SLATE_PASSWORD=

# The ID of the theme you wish to upload files to
SLATE_THEME_ID=

# A list of file patterns to ignore, with each list item separated by ':'
# These patterns are relative to the `dist/` directory of your project. Slate
# performs a number of transformations to files in the `src/` before exporting
# them to `dist/`, so the best way to make sure a file will be ignored is to run
# `node node_modules/.bin/slate-tools build` or `yarn build` and inspect the
# contents for the `dist/` directory for files you wish to ignore.
SLATE_IGNORE_FILES=

# The email of the user to register for Slate analytics. Skips prompt for email.
SLATE_USER_EMAIL=

Store / Environment Configuration Tips

Knowing what to put in your .env isn't always straightforward. This guide aims to clarify what data is needed, and where to get it.

Note: ThemeKit is the tool that powers Slate deploys. See it's configuration variables documentation for more details.

Finding your SLATE_THEME_ID

_warning: some commands (start, deploy) will overwrite the existing code on this SLATE_THEME_ID with your local project's content. To avoid losing work, we suggest you go to /admin/themes and duplicate an existing theme to work from.

Go to your store's /admin/themes.xml, and copy the id for the theme you would like to update:

https://screenshot.click/17-02-w0fw2-zczky.png

https://screenshot.click/17-04-mng8o-k9da8.png

alternatively, you can set the SLATE_THEME_ID to "live" to update the published theme

Generating your SLATE_PASSWORD

Navigate to your store's private apps page (/admin/apps/private).

https://screenshot.click/17-06-j9e9m-n2jxa.png

Create a new private app and copy the password:

https://screenshot.click/17-07-u19kf-rx53b.png

Assign the private app permissions to "Read and Write" for theme templates and theme assets:

https://screenshot.click/17-09-owv1p-5lugl.png