This is a collection of utility functions for common tasks in JavaScript. This module includes functions to work with arrays, objects, and generate unique IDs. It's designed to be simple to use and can be easily integrated into your Node.js, browser-based projects or Appsmith apps.
Note: This method requires a public Github repository.
You can clone this repo using Git to create and modify:
git clone [email protected]:appsmithorg/foundry.gitOnce cloned, you will need to install the Node modules to get it ready for usage. This should only be needed the first time (unless you add extra modules).
npm installAlternatively, you can follow the tutorial to set your own foundry up from scratch. (coming soon)
- Create a new sub-directory in the
librariesfolder. This should be the name of your custom library. - Create an
index.jsfile in that folder, and copy your code in there. Currently, this is expected to be an Appsmith JSObject. - Run
npm buildto generate the UMM file and a helpful README for your library. - Commit and push your changes to a public Github repo.
Your library is ready for usage using JSDelivr. See the generated README for the link.
Each library should be added to its own folder in the libraries directory as a single index.js file. This is intended to support simple libraries that are contained in a single file with few or no dependencies. The default expectation is that you can directly cut/paste an Appsmith JSObject into your index.js.
The repo used @rollup to process your code into a UDM file, and expects to use JSDelivr for CDN delivery.
- build - runs both the UMD & the readme file generation commands. In essence, it is the same as running
umd.generate&readme.generate. This is the default command to update your repo when you add or update a library.
npm run build- readme.generate - used to generate a readme file for each library. It uses the
jsDocLitelibrary in this repo to parse the JSDoc comments out of the libraryindex.jsfile. It will iterate over each library and save the README to that directory.
npm run readme.generate- umd.generate - used to generate the UMD code versions in the
distdirectory. This will iterate over every folder in thelibrariesdirectory and use theindex.jsin each one. The name of the folder will be the name of the library.
npm run umd.generateHere are the libraries available in this repo and how to use them. All of them are availble using JSDelivr so you can import them into your Appsmith app.
This is a simple library that uses basic JSDoc style docblocks to comment your code and generate docs. We are actually using it in this repo to automatically generate a README for each library. It doesn't offer full JSDoc support, but the basics are good.
-
usage:
https://cdn.jsdelivr.net/gh/appsmithorg/foundry@main/dist/jsDocLite.umd.js
- Can I remove the libraries in the original repo?
Yes! Thebuildcommand currently expects the jsDocLite library to be available. It uses the JSDelivr version of the library, so you can safely remove it from your clone of this repo. - Why does this method require a public Github repository?
Firstly, JSDelivr has a native Github integration that makes it easy for us to create a CDN URL without any registration or setup. Secondly, in order to work, both JSDelivr and the app need to be able to access the library over a public connection. - Why did you create a JSDocLite library instead of using JSDoc?
Partly because JSDoc is a bit overkill for our use case, and partly because we wanted a simple JSDoc parser that can be used client side... such a thing doesn't exist. Mostly - for fun.
- npm
- You will need the Rollup node modules for doing the UMD generation
- The readme.generate command relies on the jsDocLite library, which is included as a CDN call to JSDelivr.
- jsDocLite
- Allow it to work with multiple comment lines
- add @todo
- Make readme generator easier to use with a template
Contributions are always welcome! Open an issue or a PR!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
