Set Up Environment
In this section you'll learn how to set up your environment for custom component development.
Operating system considerations#
You can develop custom components on any operating system that supports NodeJS (Windows, Linux, MacOS, etc). If you use Windows, we recommend installing WSL.
Install NodeJS#
Custom 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 IDE#
If 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 tool#
The 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/prismOnce 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