How to use a customized mfe

Development
1

Hi, everyone

I’m using Tutor to run Open edX, with the edx-platform cloned and mounted for development.

I have checked the mount list with

tutor mounts list

shows mounts for openedx and openedx-dev images using the edx-platform context.

I launched the development environment with

tutor dev launch

, and the MFE container (overhangio/openedx-mfe:19.0.0-indigo) is running, mapping multiple ports (e.g., 1997->8002/tcp). However, I want to use a locally customized ‘frontend-app-authn’ MFE that I’ve forked, cloned, and modified, instead of the default MFE image.

How can I configure Tutor to use my local ‘frontend-app-authn’ repository for the MFE instead of the default overhangio/openedx-mfe:19.0.0-indigo image?

Note: other mfe are running from overhangio/openedx-mfe, my intention is to do customization for each mfe individually and test. for that i want to know how to do that atlease for a single mfe.

Please any one who can help me with this.

2

Hi @teklu,

The official documentation on how to do this is here: Tutor MFE README " MFE development"

There is also an alternate method (running the MFE on your host instead of inside docker) that is available for on some MFEs, e.g. here are the instructions for the authoring MFE.

Let us know if one of those works for you.

3

Hi @Braden,
thanks for your response,

I will check both options and let you know,

for your information, what i was doing to customize the authn mfe, first i stopped all mfe with

tutor dev stop mfe

and then run what i have cloned with

npm run dev

then that works as intended, but once i have registered or login, it will redirect to ‘/learner-dashboard’, and that mfe wasn’t running since i have stopped the entire mfe.

I will check what you suggested and let you know.

thank you again.

4

Yes, if you add an MFE like authn to your tutor mounts, then when you run tutor dev start mfe it will run all MFEs except authn, and you can decide when/how to run authn, either by using npm run dev on your host or tutor dev start authn to run it (bind mounted) inside a docker container.

3 Likes
5

Hi @braden
Thank you so much, that solves my problem.

1 Like
6

Thank you guys. It also works for me. Anyway if i want to change the indigo logo, where are the MFE repository?