By Mikaela Robertson and Kaelan Reece 27 April 2020 Techies
This process is a temporary solution and will be improved in a future release. A future version of C#Bot will resolve this issue. Thank you for your patience.
remarkable custom package to our application.
You will be required to interact with the following file(s):
|package.json||This file contains dependencies that are used in the the project.|
C#Bot uses React as its client-side framework, which makes use of NodeJS, NPM and Yarn. React uses the
package.json configuration file to help yarn know both what dependencies and packages should be installed from the NPM registry, along with how to install them. Dependencies can be installed from the command line using
yarn install [package name], and the node packages manager will add them to React project's
package.json. Alternatively, dependencies can first be added to the
package.json manually and later installed with the yarn
Custom packages can be added to node modules by running
yarn add <package name> or
yarn add --save-dev <package name> in production and development environments respectively.
However, as this file is managed by the bot, any
yarn install ... commands will put new package entries outside of the protected regions, which will be deleted whenever the bot rewrites the project. As such, manual entry of the package is required to ensure that the packages are inside protected regions. The warnings section at the bottom of this article provides more detail.
Here we will add
remarkable as a new custom package in our React project.
- Locate the following code block:
"//": [ " protected region % [Add custom development dependencies here] off begin " ],
- Turn on the protected region by replacing
- Add these lines below the code block:
These version numbers are the latest at the time of writing. Your versions may vary.
package.jsonshould now look like this:
... "//": [ " protected region % [Add custom development dependencies here] on begin " ], "remarkable": "^2.0.0", ...
- Open a new terminal and navigate to
- You are now able to use 'remarkable' in your application code.
There are a few things to be careful of when adding a new custom package:
yarn add <package name>can cause unexpected behaviour with protected regions, such as clearing them. Instead, add the package manually via the steps outlined in this article. This also applies to
yarn add --save-dev <package name>.
- Package versions as outlined in the
package.jsonfile are officially supported. Thus any modification to these versions may cause unexpected bugs or errors due to version or dependency conflicts. Instead, try updating your bot version to get the latest versions.
- Due to some limitations of the bot, protected regions in JSON files come in blocks instead of lines. As such, any modification must be made below the block as outlined in Step 4 of this article.