Skip to content

Latest commit

 

History

History
118 lines (80 loc) · 4.7 KB

README.rst

File metadata and controls

118 lines (80 loc) · 4.7 KB
Raw

frontend-lib-learning-assistant

License status-badge Continuous Integration Codecov

Purpose

This React library is the Learning Assistant frontend library. It provides the frontend code for a Learning Assistant tool. This tool is meant to be installed into the Learning micro-frontend (MFE).

This library is currently a work in progress, so documentation is not complete.

Getting Started

Devstack Installation

This library is intended for use with the Learning MFE. Please follow instructions for running the Learning MFE as documented in the repository README.

Development

This library is intended for use with the Learning MFE. In order to install a local checkout of this library into the Learning MFE instead of from npm, follow the documentation for local module development in the Learning MFE.

If you are planning to run the Learning MFE in devstack, be sure to clone this repository into a src subdirectory of your devstack workspace directory so that the code is properly mounted into the Learning MFE Docker container. You will need to update the dir key in your module.config.js file appropriately. See the Mounting frontend packages from src directory ADR in the devstack repository for further details.

If you want to install a local checkout of this library into the Learning MFE, follow the documentation mentioned above. However, if you want do active development on this library and wish to see your changes immediately reflected in the Learning MFE, then you will need to modify your module.config.js to reference the src directory of this repository in the dist key instead of the dist directory. Below is an example module.config.js for this use case. If you set up your module.config.js this way, your changes will be picked up by the Learning MFE via the hot module reloading process.:

module.exports = {
  localModules: [
      { moduleName: '@edx/frontend-lib-learning-assistant', dir: '../src/frontend-lib-learning-assistant', dist: 'src' },
  ],
};

Configuration

Note

[TODO]

Explicitly list anything that this MFE requires to function correctly. This includes:

  • A list of both required and optional .env variables, and how they each affect the functioning of the MFE
  • A list of edx-platform feature and waffle flags that are either required to enable use of this MFE, or affect the behavior of the MFE in some other way
  • A list of IDAs or other MFEs that this MFE depends on to function correctly

[TODO]

Getting Help

If you are interested in using this repository, please contact [email protected].

License

The code in this repository is licensed under the AGPLv3 unless otherwise noted.

Please see LICENSE for details.

Contributing

This repo is not currently accepting contributions.

The Open edX Code of Conduct

All community members are expected to follow the Open edX Code of Conduct.

Reporting Security Issues

Please do not report security issues in public. Email [email protected] instead.