Caution
This SDK was made for Legacy Salable and isn't compatible with the latest version of the software.
To set up the React SDK on your local machine for development, perform the following steps.
- Clone the repo to your local machine
- Run
npm iat the root of the project
Note: You don't need to run npm i per package. Because this project uses NPM workspaces, you only ever need to run it at root.
If you want to add a new package, perform the following steps.
- Create a new folder inside the
packagesdirectory named as the name of the package. (e.g. pricing-table) - Inside the new package folder, create
package.jsonandREADME.mdfiles.- Use the template for
package.jsonbelow, replacing information where required.
- Use the template for
- Create a
srcfolder in the root of your new package folder and inside it put aindex.tsorindex.jsfile depending on if you're using TS or not.- From the
index.{js|ts}file, export your package's files. This file is the entry point for Rollup to build from.
- From the
- Update
./packages/index.tsto include your new package index file to ensure it is included in the output build.- Export your new package from
./packages/index.tswith a name based on your package name.
- Export your new package from
- Update this
README.mdfile to include your new package in the list of packages at the top fo this file. - To install/uninstall NPM packages to your new package, use the following commands and replace information where required. NOTE: For your package name, use the directory name inside
./packages- Install:
npm install <NPM_PACKAGE_NAME> -w <YOUR_PACKAGE_NAME> - Uninstall:
npm uninstall <NPM_PACKAGE_NAME> -w <YOUR_PACKAGE_NAME>
- Install:
{
"name": "@salable/<YOUR_PACKAGE_NAME>",
"version": "1.0.0",
"description": "",
"type": "module",
"main": "src/index.{js|ts}",
"scripts": {
// Your scripts here
},
"author": "Salable",
"license": "MIT"
}For an example package, see the pricing-table package/directory inside ./packages.