Skip to content

Commit 77110c6

Browse files
Updating Docs & Cleaning up Code for next release
1 parent 7894dac commit 77110c6

File tree

6 files changed

+31
-85
lines changed

6 files changed

+31
-85
lines changed

README.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,7 @@ SFCC CLI
55

66
> Command Line Interface for Salesforce Commerce Cloud Sandbox Development
77
8-
![demo](https://sfcc-cli.s3.amazonaws.com/log.gif)
9-
![demo](https://sfcc-cli.s3.amazonaws.com/remote.gif)
10-
![demo](https://sfcc-cli.s3.amazonaws.com/watch.gif)
8+
![demo](https://sfcc-cli.s3.amazonaws.com/demo.gif)
119

1210

1311
Introduction
@@ -19,7 +17,7 @@ Make developing for Salesforce Commerce Cloud work with any IDE on MacOS, Window
1917
- [X] Watch for code changes and upload in background ( without being prompted for passwords )
2018
- [X] Support for Eclipse Build Processes
2119
- [X] Log Viewing with Advanced Search & Filter Capabilities
22-
- [X] Sandbox Storefront "Remote Control"
20+
- [X] SFCC CLI integration via [Browser Extension](https://github.com/redvanworkshop/sfcc-remote)
2321

2422

2523
Developer Overview
@@ -44,20 +42,20 @@ Developer Overview
4442
Install
4543
---
4644

47-
#### Install via Clone
45+
#### Install via NPM
4846

4947
```bash
50-
cd ~
51-
git clone https://github.com/redvanworkshop/sfcc-cli.git
52-
cd sfcc-cli
53-
npm install -g --no-optional
48+
npm install -g sfcc-cli --no-optional
5449
sfcc setup
5550
```
5651

57-
#### Install via NPM
52+
#### Install via Clone
5853

5954
```bash
60-
npm install -g sfcc-cli --no-optional
55+
cd ~
56+
git clone https://github.com/redvanworkshop/sfcc-cli.git
57+
cd sfcc-cli
58+
npm install -g --no-optional
6159
sfcc setup
6260
```
6361

bin/cli.js

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,10 +113,16 @@ const argv = yargs
113113
}
114114
})
115115
.command('remote [client] [instance]', 'Enable Support for Browser Extension')
116+
.example('sfcc setup', 'Setup SFCC Development')
117+
.example('sfcc list', 'List Configured SFCC Clients')
116118
.example('sfcc delete my-client sandbox', 'Delete my-client sandbox config')
117119
.example('sfcc watch my-client sandbox', 'Watch for my-client sandbox changes')
118120
.example('sfcc log -i customerror --latest', 'Watch Latest Custom Error Logs')
119121
.example('sfcc remote', 'Live Reload Sandbox Storefront on Changes')
122+
.example(' ', ' ')
123+
.example('----------------------------------', '------------------------------------------')
124+
.example('NEED MORE HELP ?', 'https://bit.ly/sfcc-cli-help')
125+
.example('----------------------------------', '------------------------------------------')
120126
.demand(1)
121127
.help()
122128
.version().argv

commands/setup.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ const path = require('path')
55
const prompt = require('prompt')
66
const slug = require('slug')
77

8-
const config = require('../lib/config')()
98
const builds = require('../lib/builds')
9+
const config = require('../lib/config')()
1010

1111
module.exports = async () => {
1212
const setDefaults =

docs/cmd-remote.md

Lines changed: 12 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -5,54 +5,32 @@
55
`sfcc remote`
66
---
77

8-
> Remote Control for your Sandbox Storefront
8+
> Connect to SFCC CLI via Browser Extension
99
1010
![demo](https://sfcc-cli.s3.amazonaws.com/remote.gif)
1111

12-
If you only have a single project, you can run:
1312

14-
```bash
15-
sfcc remote
16-
```
17-
18-
If needed to setup multiple clients, or multiple instances for the same client, you will need to specify what to use:
19-
20-
```bash
21-
sfcc remote <client> <instance>
22-
```
23-
24-
**FLAGS:**
25-
26-
Name | Param | Default | Definition
27-
------------|-----------------|---------|----------------------------------------------
28-
Live Reload | `--live-reload` | `false` | Enable Live Reload on Code Change
29-
30-
31-
Live Reload
13+
Browser Extension Setup
3214
---
3315

34-
This option is uses in conjunction with `sfcc watch` and when an upload is completed to your sandbox, a message is sent to to the page that it needs to refresh the page. There is a slight delay to prevent multuple reloads, in the event that you have a build process that was kicked off in the background.
35-
36-
To enable support for this, you need to make sure to install and setup the [rvw_devtools](https://github.com/redvanworkshop/rvw_devtools) cartridge on your sandbox.
16+
To get started, you'll need to [Install the Browser Extension](https://github.com/redvanworkshop/sfcc-remote).
3717

38-
This will inject the following HTML snippet into your sandbox:
39-
40-
```html
41-
<script src="https://localhost:8443/sfcc-cli-remote.js" id="sfcc-cli-remote"></script>
42-
```
43-
44-
Once this is complete, you should only need to run the following command:
18+
Once you have the browser extension installed, you will need to do the following:
4519

4620
```bash
47-
sfcc remote <client> <instance> --live-reload
21+
sfcc remote
4822
```
4923

24+
Once the remote is turned on, all your `sfcc log` and `sfcc watch` output will be pushed to the browser extension.
5025

5126
SSL Certificates
5227
---
5328

5429
In order for the SSL certificates to work locally, you will need to add the certificate to your system keys.
5530

31+
<details><summary>VIEW INSTRUCTIONS</summary>
32+
<p>
33+
5634
For MacOS you can do this:
5735

5836
```bash
@@ -68,3 +46,6 @@ openssl req -x509 -newkey rsa:2048 -out sfcc-cli-ca.cer -outform PEM -keyout sfc
6846
openssl req -newkey rsa:2048 -keyout sfcc-cli-localhost.pvk -out sfcc-cli-localhost.req -subj /CN=localhost -sha256 -nodes
6947
openssl x509 -req -CA sfcc-cli-ca.cer -CAkey sfcc-cli-ca.pvk -in sfcc-cli-localhost.req -out sfcc-cli-localhost.cer -days 10000 -extfile sfcc-cli.ext -sha256 -set_serial 0x1111
7048
```
49+
50+
</p>
51+
</details>

docs/cmd-setup.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,11 @@ otherwise:
2626
#### Pass Params via CLI
2727

2828
```bash
29-
sfcc setup -c "My Client" -h dev04-web-mysandbox.demandware.net -d /Users/RVW/Projects/mysandbox -u [email protected] -p "my^pass"
29+
sfcc setup -c "My Client" -h dev04-web-mysandbox.demandware.net -d /Users/RVW/Projects/mysandbox -u [email protected] -p 'my^pass'
3030
```
3131

32+
NOTE: When using the password flag, make sure to wrap the text with SINGLE QUOTES. Using Double Quotes will cause issues with passwords that contain dollar signs.
33+
3234
**FLAGS:**
3335

3436
Name | Param | Required | Default | Definition

remote/sfcc-cli-remote.js

Lines changed: 0 additions & 41 deletions
This file was deleted.

0 commit comments

Comments
 (0)