Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Copyright (C) 2018-2019 The Open Library Foundation

This software is distributed under the terms of the Apache License, Version 2.0. See the file "LICENSE" for more information.


The Licenses UI Module, or ui-licenses, is a Stripes UI module used for management of licenses


In order to view and log into the platform being served up, a suitable Okapi backend will need to be running. The Folio testing-backend Vagrant box should work if your app does not yet have its own backend module.

Additionally, until it is part of the Okapi backends, the mod-licenses module needs to be running.


Note that the following commands require that stripes-cli is installed globally.

Run the following from the ui-licenses directory to serve ui-licenses by itself using a development server:

stripes serve

Note: When serving up a newly created app that does not have its own backend permissions established, pass the --hasAllPerms option to display the app in the UI navigation. For example:

stripes serve --hasAllPerms

To specify your own tenant ID or to use an Okapi instance other than http://localhost:9130, pass the --okapi and --tenant options.

stripes serve --okapi --tenant my-tenant-id

To run ui-licenses within a Stripes platform:

  1. Create a workspace with stripes workspace and select whatever modules you want (e.g., ui-users and ui-licenses) and at least one platform such as stripes-sample-platform.
  2. Navigate to the platform's directory and run stripes serve stripes.config.js.local.

Additional information

Read the Stripes Module Developer's Guide.

See project UILIC at the FOLIO issue tracker.

Other FOLIO Developer documentation is at