diff options
| -rw-r--r-- | LICENSE | 21 | ||||
| -rw-r--r-- | README.md | 102 | ||||
| -rw-r--r-- | src/api/README.md | 6 |
3 files changed, 125 insertions, 4 deletions
@@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2025 General Research Laboratories, LLC + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE.
\ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..de05150 --- /dev/null +++ b/README.md @@ -0,0 +1,102 @@ +# [Panel UI](https://github.com/GRL/panel-ui) · [](./LICENSE)  [](https://cdn.generalresearch.com/grl-panel.js)   + +### General Research Supplier and Panel Interface + +This project provides various front-end React components that leverage the General +Research [Full-Service Brokerage API](https://fsb.generalresearch.com/redoc/). There are no private API calls or +functionality. + +## Integration Example + +```js +<script + src="https://cdn.generalresearch.com/grl-panel.js" + //-- Essential: + // -- This is your Product ID. Provided by General Research + data-bpid="d0606a0b5d034a8d81b1e3579d1f76fd" + + // -- The ID of a div on the page that you would like to widget + // to be placed. Allows custom resizing and styling of the + // Panel UI widget + data-target="div9f1dcb68" + + // -- The Brokerage Product User ID, a unique user + // identifier. Should be a random uuid or hash + // that is consistent for a user. + data-bpuid="grl-panel-ui-example-c67bfe924d80" + + //-- User Interface Configuration + data-panel="General Insights" +></script> +``` + +## Build Status and Content Delivery + +<table> + <tr> + <td><strong>Branches</strong></td> + <td><strong>Versions</strong></td> + </tr> + <tr> + <td> + <a href="https://cdn.generalresearch.com/grl-panel.js"> + <img src="https://cdn.generalresearch.com/buildStatus/icon?subject=master&job=panel-ui%2Fmaster"> + </a> + </td> + <td> + <a href="https://cdn.generalresearch.com/grl-panel-v0.1.1.js"> + <img src="https://cdn.generalresearch.com/buildStatus/icon?subject=v0.1.1&job=panel-ui%2Fv0.1.1"> + </a> + </td> + </tr> + <tr> + <td> + <a href="https://cdn.generalresearch.com/grl-panel-dev.js"> + <img src="https://cdn.generalresearch.com/buildStatus/icon?subject=dev&job=panel-ui%2Fdev"> + </a> + </td> + <td> + <a href="https://cdn.generalresearch.com/grl-panel-v0.2.1.js"> + <img src="https://cdn.generalresearch.com/buildStatus/icon?subject=v0.2.1&job=panel-ui%2Fv0.2.1"> + </a> + </td> + </tr> +</table> + +Please click on the build status badges to access the CDN hosted javascript for you to use. + +## How to build your own Panel UI + +### Running Development + +``` +npm install +npm dev +``` + +### Building Production + +``` +npm install +npm build +``` + +If successful, a single file will be generaged at `/dist/grl-panel.js` which you can then use to place on your own CDN +or web server. + +## API Documentation and Interfaces + +A design pattern and goal of the Panel UI project is to not use any proprietary or custom models or object definitions +within the project itself. By leveraging [openapi-generator-cli](https://github.com/OpenAPITools/openapi-generator-cli) +all the required models and API endpoints can be built from the General +Research [https://fsb.generalresearch.com/redoc/](FSB Documentation) openapi +file [available here](https://fsb.generalresearch.com/openapi.json). + +This project contains the prebuilt interfaces and endpoint classes for the API. However, instructions to build it +yourself is available in the [@/src/api/README.md](./src/api/README.md) file. + +## License + +Panel UI is [MIT licensed](./LICENSE). + +> *Do what you want, just give credit.*
\ No newline at end of file diff --git a/src/api/README.md b/src/api/README.md index 8eed370..4f38b66 100644 --- a/src/api/README.md +++ b/src/api/README.md @@ -1,5 +1,6 @@ +# Panel UI OpenAPI Definitions -``` +```bash brew install openjdk export PATH="/opt/homebrew/opt/openjdk/bin:$PATH" export CPPFLAGS="-I/opt/homebrew/opt/openjdk/include" @@ -7,9 +8,6 @@ export CPPFLAGS="-I/opt/homebrew/opt/openjdk/include" source ~/.zshrc # or source ~/.bash_profile java -version - - wget https://fsb.generalresearch.com/openapi.json - openapi-generator-cli generate -i ./openapi.json -g typescript-axios -o ./ ```
\ No newline at end of file |