{"id":29687292,"url":"https://github.com/thepalaceproject/library-registry-admin","last_synced_at":"2026-01-20T16:36:36.423Z","repository":{"id":44663061,"uuid":"365339358","full_name":"ThePalaceProject/library-registry-admin","owner":"ThePalaceProject","description":"An administrative user interface for the Palace library registry service.","archived":false,"fork":false,"pushed_at":"2025-03-14T14:17:53.000Z","size":13443,"stargazers_count":0,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-23T04:42:51.239Z","etag":null,"topics":["frontend","library-registry","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThePalaceProject.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-05-07T19:54:15.000Z","updated_at":"2025-03-14T14:16:01.000Z","dependencies_parsed_at":"2023-11-07T18:43:18.290Z","dependency_job_id":null,"html_url":"https://github.com/ThePalaceProject/library-registry-admin","commit_stats":{"total_commits":334,"total_committers":7,"mean_commits":"47.714285714285715","dds":0.2425149700598802,"last_synced_commit":"a15eff4bffa02f13383515fba002efb97a2805bc"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ThePalaceProject/library-registry-admin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePalaceProject%2Flibrary-registry-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePalaceProject%2Flibrary-registry-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePalaceProject%2Flibrary-registry-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePalaceProject%2Flibrary-registry-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThePalaceProject","download_url":"https://codeload.github.com/ThePalaceProject/library-registry-admin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThePalaceProject%2Flibrary-registry-admin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266619012,"owners_count":23957273,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["frontend","library-registry","typescript"],"created_at":"2025-07-23T04:36:35.967Z","updated_at":"2026-01-20T16:36:36.383Z","avatar_url":"https://github.com/ThePalaceProject.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Library Registry Administrative Interface\n\n[![Test](https://github.com/ThePalaceProject/library-registry-admin/actions/workflows/test.yml/badge.svg)](https://github.com/ThePalaceProject/library-registry-admin/actions/workflows/test.yml)\n[![npm version](https://badge.fury.io/js/%40thepalaceproject%2Flibrary-registry-admin.svg)](https://badge.fury.io/js/%40thepalaceproject%2Flibrary-registry-admin)\n[![Deploy Documentation](https://github.com/ThePalaceProject/library-registry-admin/actions/workflows/gh-pages.yml/badge.svg)](https://github.com/ThePalaceProject/library-registry-admin/actions/workflows/gh-pages.yml)\n\nThis is a [LYRASIS](http://lyrasis.org)-maintained fork of the NYPL [Library Simplified](http://www.librarysimplified.org/) Library Registry administrative interface.\n\n## Library Simplified Documentation\n\nTo see screenshots, read in-depth documentation, and find out more about the project, check out the [Confluence](https://confluence.nypl.org/display/SIM/) site hosted by The New York Public Library.\n\n## Setup\n\nThis package is meant to be used with The Palace Project [Library Registry](https://github.com/thepalaceproject/library-registry).\n\nNode.js version 22 is required to build and run the administrative interface.\n\n### Cloning this repository\n\nSuggested local folder setup:\n- `/[path to project folder]/library-registry`\n- `/[path to project folder]/library-registry-admin`\n\n### Running with a remote registry server\n\nIf you're working on the administrative interface and want to test local changes against a remote library registry, you can run the administrative interface using the command:\n\n```\nnpm run dev-server -- --env=backend=[url]\n```\n\nFor example, `npm run dev-server -- --env=backend=https://registry-tpp-qa.palaceproject.io`. The admin UI can then be accessed at `http://localhost:8080/admin/`.\n\nThis works by running a local proxy server. HTML pages received from the Library Registry that load assets from the `library-registry-admin` package on jsdelivr are rewritten to load them from the local webpack build instead.\n\nWebpack will take care of compiling and updating any new changes made locally for development. Hot module replacement and live reloading are enabled, so the browser will automatically update as changes are made.\n\n### Running with a local registry server\n\nIf you're working on the administrative interface and want to test local changes against a local library registry, you can link your local clone of this repository to your local library registry. These steps will allow you to work on the front-end administrative interface and see updates while developing.\n\n1. Run `npm link` in this `library-registry-admin` repository,\n2. run `npm link library-registry-admin` from the `library-registry` repository,\n2. run the library registry using `python app.py` at the root in the `library-registry` repository,\n3. run the web interface using `npm run dev` at the root of this `library-registry-admin` repository,\n4. visit `localhost:7000/admin/`\n\nWebpack will take care of compiling and updating any new changes made locally for development. Just refresh the page to see updates without having to restart either the `library-registry` or `library-registry-admin` servers.\n\n## Publishing\n\n\u003c!-- This package is [published to npm](https://www.npmjs.com/package/@thepalaceproject/library-registry-admin). --\u003e\n\nWe use GitHub Actions for publishing. This package is published automatically when a new release is created.\n\n## Accessibility\n\nIn order to develop user interfaces that are accessible to everyone, there are tools added to the workflow. Besides the Typescript `tslint-react-a11y` plugin, `react-axe` is also installed for local development. Using that module while running the app uses a lot of resources so it should be only when specifically testing for accessibility and not while actively developing new features or fixing bugs.\n\nIn order to run the app with `react-axe`, run `npm run dev-test-axe`. This will add a local global variable `process.env.TEST_AXE` (through webpack) that will trigger `react-axe` in `/src/index.tsx`. The output will be seen in the _browser's_ console terminal.\n\n## Tests\n\nLike the codebase, all the unit tests are written in Typescript. Tests are written for all React components as well as redux and utility functions, and all can be found in their respective `__tests__` folders.\n\nTo run the tests, perform `npm test`.\n\nWe use GitHub Actions for continuous integration. Any pull requests submitted must have tests and those tests must pass during the CI checks.\n\n## License\n\n```\nCopyright © 2015 The New York Public Library, Astor, Lenox, and Tilden Foundations\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepalaceproject%2Flibrary-registry-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthepalaceproject%2Flibrary-registry-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthepalaceproject%2Flibrary-registry-admin/lists"}