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.
This library is intended for use with the Learning MFE. Please follow instructions for running the Learning MFE as documented in the repository README.
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' },
],
};
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]
If you are interested in using this repository, please contact team-cosmonauts@edx.org.
The code in this repository is licensed under the AGPLv3 unless otherwise noted.
Please see LICENSE for details.
This repo is not currently accepting contributions.
All community members are expected to follow the Open edX Code of Conduct.
Please do not report security issues in public. Email security@edx.org instead.