search

Shopify / slate

Slate is a toolkit for developing Shopify themes. It's designed to assist your workflow and speed up the process of developing, testing, and deploying themes.
https://shopify.github.io/slate
MIT License
1.28k stars 364 forks source link

slate-tools command not found #945

Closed jasminetealady closed 5 years ago

jasminetealady commented 5 years ago

Problem

Hi. I am brand new to Shopify and Slate. The problem is that upon following the documentation and entering the command to create a new project, the slate-tools command does not work (command is not found).

Replication steps

I followed the instructions in the documentation and ran yarn create slate-theme my-new-theme. It specifies that as the singular command necessary to get started. Upon opening the project and running slate-tools as well as slate, I get this:

screen shot 2019-01-13 at 11 40 16 pm

After browsing issues, a combination of things ended up getting the slate command to work, but this is not the slate-tools command that is specified in the current documentation. I changed the slate-tools version in package.json to "0.13.0", ran npm install (instead of yarn) then npm audit fix (which changed it to "@shopify/slate-tools": "^0.14.0",) and now it works. However, I'm still concerned about not being up to date and why as a new user following the documentation, it doesn't work as expected.

More Information

Additional helpful information may be that I am using zsh. And also here is the screenshot of exactly what happens during a fresh run of the yarn create slate-theme my-new-theme command:

screen shot 2019-01-13 at 11 51 03 pm

Running yarn start after does run and asks me if I want to deploy but I can't do any slate-tools commands explicitly.

Please excuse any gaps of knowledge. Thank you

t-kelly commented 5 years ago

Hey @avelineamour -- looks like you're jumping between v0 and v1 docs, which are not compatible with eachother. I'd recommend sticking to v1.

The slate-tools commands are typically used the the themes package.json file under the scripts key. In Starter Theme (the default theme that is installed when you call yarn create slate-theme), you will see some examples of how slate-tools is used. To call these scripts, you want to call yarn [name of script], eg. yarn start, yarn deploy, etc.

jasminetealady commented 5 years ago

Thanks! I wasn't jumping between docs -- I was only using the v1 doc. When the commands weren't working as expected, that's when I went looking for a solution. It was not clear that the commands had to be called with yarn -- I was explicitly entering slate-tools build etc because that's how it was written on the Commands page of the docs. It would be super helpful to specify that they should be called with yarn in the docs. Thank you though! I got it now.

lock[bot] commented 5 years ago

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.