Set Up Environment
In this section you'll learn how to set up your environment for custom component development.
#
Operating system considerationsYou can develop custom components on any operating system that supports NodeJS (Windows, Linux, MacOS, etc). If you use Windows, we recommend installing WSL.
#
Install NodeJSCustom components are written in NodeJS (with TypeScript layered on top). While many version of NodeJS can be used to build custom components, we recommend using the latest LTS version available on NodeJS.org.
Once you install NodeJS, ensure that you can run both node --version
and npm --version
.
#
Install an IDEIf you have a favorite code editor, use that. We've found that VS Code works great for custom component development, but some of our developers prefer Sublime or neovim.
It's not necessary, but if you use VS Code we've found the following extensions helpful:
- ES Lint for code linting
- Prettier for code formatting
- Version Lens for showing the latest version for each package in package.json
VS Code has built-in TypeScript IntelliSense (auto-complete), but if you want to use the latest-and-greatest, you can also install the TypeScript Nightly build extension.
#
Install the Prismatic CLI toolThe Prismatic CLI tool, prism
is used for initializing and publishing custom components.
You can install it after installing NodeJS and npm
with this command:
npm install --global @prismatic-io/prism
Once you've installed prism
, log in by typing prism login
.
You'll be prompted to enter your Prismatic credentials, and then to authorize prism
to access your Prismatic account.
Click Accept.
Once you've logged in, run prism me
to verify that you are logged in.
$ prism meName: John DoeEmail: john.doe@example.comOrganization: Example Corp - US RegionEndpoint URL: https://app.prismatic.io