{"id":18950043,"url":"https://github.com/salesforce/refocus-ldk","last_synced_at":"2025-04-15T23:31:37.211Z","repository":{"id":45302992,"uuid":"69385604","full_name":"salesforce/refocus-ldk","owner":"salesforce","description":"Refocus Lens Developer Kit - a toolkit for developing, testing and packaging Refocus lenses for deployment","archived":false,"fork":false,"pushed_at":"2023-03-27T19:14:20.000Z","size":934,"stargazers_count":7,"open_issues_count":5,"forks_count":9,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-04-08T00:13:15.842Z","etag":null,"topics":["refocus"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/salesforce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null}},"created_at":"2016-09-27T18:16:21.000Z","updated_at":"2023-08-21T18:54:39.000Z","dependencies_parsed_at":"2023-09-24T16:57:05.607Z","dependency_job_id":null,"html_url":"https://github.com/salesforce/refocus-ldk","commit_stats":{"total_commits":30,"total_committers":7,"mean_commits":4.285714285714286,"dds":0.6333333333333333,"last_synced_commit":"3121156a2b5495f010689567ffae9ab9a80e02af"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforce%2Frefocus-ldk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforce%2Frefocus-ldk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforce%2Frefocus-ldk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforce%2Frefocus-ldk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/salesforce","download_url":"https://codeload.github.com/salesforce/refocus-ldk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223689739,"owners_count":17186489,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["refocus"],"created_at":"2024-11-08T13:20:28.750Z","updated_at":"2024-11-08T13:20:29.930Z","avatar_url":"https://github.com/salesforce.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# refocus-ldk\n\n## Refocus Lens Developer Kit\n\nNote: this repository is infrequently maintained.\n\nThe Refocus Lens Developer Kit (LDK) is a toolkit for developing, testing and packaging [Refocus](https://github.com/salesforce/refocus) lenses for deployment.\n\n- [Introduction](#introduction)\n- [Install](#install)\n- [Configure](#configure)\n- [Create](#create)\n- [Implement](#implement)\n- [Prototype](#prototype)\n- [Test](#test)\n- [Build](#build)\n- [Deploy](#deploy)\n\n### Introduction\n\n[Refocus](https://github.com/salesforce/refocus) is a platform for visualizing the status of some set of subjects under monitoring. The platform does not attempt to provide visualizations to satisfy every type of user. Instead, it allows users to install add-on modules, which we call *lenses*, to provide new visualizations. Each lens provides a new visualization to help users understand their data in a new way. \n\nThe LDK lets you build and test a lens quickly and iteratively, *without* having to install it into a running Refocus application. The LDK also provides some dummy datasets and simulates realtime events so you can test how your lens handles hierarchy data and realtime events.\n\nThe LDK comes with an \"Example\" lens pre-installed in the `./Lenses` directory--you can use this to get familiar with how a lens works or as a jumping-off point for developing your own lens.\n\n### Install\n\n```\ngit clone https://github.com/salesforce/refocus-ldk.git\ncd refocus-ldk\nnpm install\n```\n\n### Configure\n\nSince you can work on multiple lenses in the LDK, in this step you specify the name of the lens you want to work on (or create) right now.\n\n\u003e **Note: All the other `npm run ...` scripts depend on this config setting!**\n\n```\nnpm config set refocus-ldk:lens SuperDuperLens\n```\n\n\u003e If you are working on multiple lenses and you aren't sure which lens you are currently using, you can run `npm config list | grep refocus-ldk:lens`.\n\n### Create\n\nCreate a basic directory structure with some starter files so you can get right into developing, testing and packaging your new lens.\n\n```\nnpm run create\n```\n\n### Implement\n\nSee the [Lens Developer Guide](LensDeveloperGuide.md) for help, guidelines and reference materials.\n\n### Prototype\n\nIn one terminal, from your `refocus-ldk` directory, start the LDK-Prototyper, a local app server which renders your lens in a browser for rapid prototyping.\n\n```\nnpm run prototype\n```\n\nIn another terminal, also from your `refocus-ldk` directory, automatically compile your code as you make changes so you can see the results in the browser immediately (just refresh http://localhost:3000).\n\n```\nnpm run compile-watch\n```\n\n### Test\n\nRun all the tests under your lens's `test` directory.\n\n```\nnpm run test\n```\n\n### Build\n\nBefore you build your lens, you should update your lens metadata in `./SuperDuperLens/lens.json`.\nNote: \"lensEventApiVersion\" currently defaults to 1.\n\nPackage up all your lens resources into `./dist/SuperDuperLens.zip` for deployment using the build script:\n\n```\nnpm run build\n```\n\nDuring the build process, webpack bundles up all the javascript files and dependencies required by `./SuperDuperLens/src/main.js` into `./SuperDuperLens/lens.js`, then that gets zipped up into `./dist/SuperDuperLens.zip` along with `./SuperDuperLens/lens.json`.\n\n### Deploy\nWhen you are ready to install your new lens into Refocus, upload `./dist/SuperDuperLens.zip` as your lens `library` file use the Refocus API (`/v1/lenses`) or Refocus UI.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalesforce%2Frefocus-ldk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsalesforce%2Frefocus-ldk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalesforce%2Frefocus-ldk/lists"}