From 4b8f37b39b1fd6c5762863d9ef2d6d39b2a3ae92 Mon Sep 17 00:00:00 2001 From: dataengineervishal Date: Fri, 15 Aug 2025 00:52:56 +0530 Subject: [PATCH 1/2] Add troubleshooting instructions for TemplateNotFound error during Breeze setup This updates the contributor quick start documentation to include a troubleshooting note for the error: jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist' The note instructs users to run `breeze compile-ui-assets` before starting the Breeze environment if they encounter this error, and to verify that UI assets are added to `/airflow/.build/ui`. This helps contributors resolve frontend asset issues during initial setup. Also clarifies the placement of this step relative to existing Breeze initialization instructions. --- .../03_contributors_quick_start.rst | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/contributing-docs/03_contributors_quick_start.rst b/contributing-docs/03_contributors_quick_start.rst index ccc9a3ecac8b1..35032cd917afa 100644 --- a/contributing-docs/03_contributors_quick_start.rst +++ b/contributing-docs/03_contributors_quick_start.rst @@ -445,6 +445,26 @@ see in CI in your local environment. Once the package is installed, execute the breeze command again to resume image building. + If you encounter an error such as + + .. code-block:: text + + jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist' + + you may need to compile the UI assets before starting the Breeze environment. To do so, run the following command **before** executing step 4: + + .. code-block:: bash + + breeze compile-ui-assets + + After running this, verify that the compiled UI assets have been added to ``/airflow/.build/ui``. + + Then, proceed with: + + .. code-block:: bash + + breeze --python 3.10 --backend postgres + 5. When you enter the Breeze environment you should see a prompt similar to ``root@e4756f6ac886:/opt/airflow#``. This means that you are inside the Breeze container and ready to run most of the development tasks. You can leave From 57118475a662a208014c1d89f0011bdf9390524b Mon Sep 17 00:00:00 2001 From: dataengineervishal Date: Fri, 15 Aug 2025 02:26:53 +0530 Subject: [PATCH 2/2] fix: address lint and doc build issues --- contributing-docs/03_contributors_quick_start.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contributing-docs/03_contributors_quick_start.rst b/contributing-docs/03_contributors_quick_start.rst index 35032cd917afa..fb556ae9061fa 100644 --- a/contributing-docs/03_contributors_quick_start.rst +++ b/contributing-docs/03_contributors_quick_start.rst @@ -458,7 +458,7 @@ see in CI in your local environment. breeze compile-ui-assets After running this, verify that the compiled UI assets have been added to ``/airflow/.build/ui``. - + Then, proceed with: .. code-block:: bash