https://fib3.github.io/ssjs-vsc/
VSCode extension to streamline Server Side JS development for SalesForce Marketing Cloud.
https://fib3.github.io/ssjs-vsc/
ampscript cloud-pages marketing-cloud salesforce server-side-javascript sfmc ssjs vscode vscode-extension
Last synced: about 1 year ago
JSON representation
VSCode extension to streamline Server Side JS development for SalesForce Marketing Cloud.
- Host: GitHub
- URL: https://fib3.github.io/ssjs-vsc/
- Owner: FiB3
- License: bsd-4-clause
- Created: 2023-09-13T12:40:36.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-11T19:47:47.000Z (about 1 year ago)
- Last Synced: 2025-04-11T20:27:28.016Z (about 1 year ago)
- Topics: ampscript, cloud-pages, marketing-cloud, salesforce, server-side-javascript, sfmc, ssjs, vscode, vscode-extension
- Language: CSS
- Homepage: https://fib3.vercel.app/ssjs-vsc
- Size: 5.69 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-sfmc - SSJS Manager
README
# SSJS Manager
Simplify & speed up Server Side JavaScript and AMPscript development in Salesforce Marketing Cloud.
From syntax highlight through rapid testing and preview in VS Code and Cursor.
## Features
- Support rapid code development of SSJS scripts via SFMC's Cloud Pages.
- Preview within VSCode / Cursor - with a WYSIWYG for Cloud Pages and more information rich preview for scripts.
- Syntax highlight.
- SSJS Snippets.
- Mustache templating of scripts and pages to ensure your env security when using repositories.
- Live Previvew feature for pure HTML files that includes templating.
- Configuration Wizard UI.
### [Complete Guide](https://fibworks.com/ssjs-vsc)
[Issue Reporting on GitHub](https://github.com/FiB3/ssjs-vsc/issues)
## Settings
### Extension Settings
__Generic__ extension settings is available in VSCode Preferences.
__Project wide__ settings is done per your project (a.k.a. Workspace). One project works for one Busines Unit in SFMC.
It is managed via `SSJS: Show Config` command and stored in the `.vscode/ssjs-setup.json` file.
### Project Setup
You can start using this extension for basic features right away. However in order to use support for rapid Cloud-page development, you must install connection to SFMC. This connection consists of Installed Package, Cloud Page & Text Resource.
You can see a guide using the new `SSJS: Show Config` command for interactive wizard. It is really easy!
## Development
Once your SSJS Manager is Active and Cloud Page published, all you need to do is to create script and upload it to Marketing Cloud:
- First time upload is done via `SSJS: Upload Script to Dev` or cloud icon in top right corner of editor tab.
- `SSJS: Run` lets your preview your script or opens the script in the browser (depending on your Prefereces).
- `SSJS: Get Dev Path` command will give you the deployed URL.
### Commands
To be run using `Ctrl` + `Shift` + `P` (Win) / `CMD` + `Shift` + `P` (Mac) / F1.
The list of all commands can be seen in the `Extensions > SSJS Manager > Features > Comnands`.
### Live Preview
Sometimes you might want to develop your page locally, without SFMC Engagement and might need templating.
Enter Live Preview.
### Hooks
This option allows setting `on-save` hooks for files so you can run specific commands on save (and before sending scripts to SFMC). E.g.:
```json
// .vscode/ssjs-setup.json:
{
// ...
"hooks": {
"on-save": {
".js": {
"enabled": true, // is hook enabled?
"command": "npm run build", // command to run
"success-handling": "upload-self", // "upload-self", "upload-output", "none"
"output-file": "./dist/{{name}}.ssjs" // path to deploy, from workspace root
}
}
}
}
```
## Telemetry
This extension is collecting some telemetry in order to allow for future improvements and bugfixes.
## Sponsors
I would like to thank my sponsors:
[](https://www.weareflo.com/)
(former bluez.io)
Let me know, if you would like to sponsor me.
No personal information, API Keys nor script content is collected and VSCode overall telemetry opt-out is honored.
## Known Issues
Work in progress - some errors may appear.
In such case, let me know on my [GitHub here!](https://github.com/fib3/ssjs-vsc/issues)
- Upcoming improvements to security of development Cloud Pages.
- Multi-root workspaces are not supported.