Skip to content

docs: updates for outdated references #966

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
AntonOfTheWoods wants to merge 3 commits into
base: master
Choose a base branch
from
Open

docs: updates for outdated references #966

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ff68b72
docs: remove obsolete app devstack readme sections
AntonOfTheWoods Dec 10, 2025
88347a1
docs: remove refs to obsolete devstack in readme
AntonOfTheWoods Dec 10, 2025
b6e20b8
docs: Generify currently supported node version
AntonOfTheWoods Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
docs: remove obsolete app devstack readme sections 
Signed-off-by: Anton Melser <[email protected]>
  • Loading branch information
@AntonOfTheWoods
AntonOfTheWoods committed Dec 10, 2025
commit ff68b720978d7bcff4519ee6c7c49ffa4b5bb8e9
88 changes: 11 additions & 77 deletions README-template-frontend-app.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,91 +42,25 @@ by the new Fantastico storage engine.
Getting Started
===============

Devstack Installation
---------------------
Prerequisites
=============

The Tutor_ platform is a prerequisite for developing an MFE.
Utilize `relevant tutor-mfe documentation`_ to guide you through
the process of MFE development within the Tutor environment.

.. _Tutor: https://github.com/overhangio/tutor

.. _relevant tutor-mfe documentation: https://github.com/overhangio/tutor-mfe#mfe-development

.. note::

[TODO]

Describe in detail how this MFE can be installed and set up for development
in a devstack. Include as many screenshots as you can to make your guide
with tutor. Include as many screenshots as you can to make your guide
easier to follow! Use the following steps as an example:

Follow these steps to provision, run, and enable an instance of the
[PLACEHOLDER] MFE for local development via the `devstack`_.

.. _devstack: https://github.com/openedx/devstack#getting-started

#. To start, clone the devstack repository as a child of an arbitrary ``~/workspace/`` directory.

.. code-block::

mkdir -p ~/workspace/
cd ~/workspace/
git clone https://github.com/openedx/devstack.git

#. Configure default services and setup devstack

Create a ``devstack/options.local.mk`` file with only the services required.
Commonly, this will just be the LMS:

.. code-block::

DEFAULT_SERVICES ?= \
lms

#. Start the devstack with:

.. code-block::

cd devstack
make dev.pull
make dev.provision
make dev.up

#. In an LMS shell, enable the ``ENABLE_[PLACEHOLDER]_MICROFRONTEND`` feature flag:

.. code-block::

make lms-shell
vim /edx/etc/lms.yml
---
FEATURES:
ENABLE_[PLACEHOLDER]_MICROFRONTEND: true

Exit the shell and restart the LMS so changes take effect:

.. code-block::

make lms-restart

#. Create and enable the waffle flag required to redirect users to the MFE,
enabling it for everyone:

.. code-block::

make lms-shell
./manage.py lms waffle_flag --create --everyone [PLACEHOLDER].redirect_to_microfrontend

#. Start this MFE with:

.. code-block::

cd frontend-app-[PLACEHOLDER]
nvm use
npm ci
npm start

#. Finally, open the MFE in a browser

Navigate to `http://localhost:8080 <http://localhost:8080>`_ to open the
MFE. This is what it should look like if everything worked:

.. figure:: ./docs/images/template.jpg

"Polycon marking template" by mangtronix is licensed under CC BY-SA 2.0.

Configuration
-------------

Expand Down