docs: Guide for resolving UI TemplateNotFound in Breeze setup by dataengineervishal · Pull Request #54521 · apache/airflow

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

dataengineervishal · 2025-08-14T19:38:01Z

This pull request updates the contributor quick start documentation to help users resolve a common issue that can occur when setting up the Breeze environment. Specifically, it adds troubleshooting instructions for the following error:

jinja2.exceptions.TemplateNotFound: '/index.html' not found in search path: '/opt/airflow/airflow-core/src/airflow/ui/dist'

The documentation now instructs users to run breeze compile-ui-assets before initializing the Breeze environment if they encounter this error, and to verify that the compiled UI assets are present in /airflow/.build/ui before proceeding.

This addition aims to make the onboarding process smoother and to help new contributors quickly resolve UI asset-related errors during setup.

boring-cyborg · 2025-08-14T19:38:04Z

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

Pay attention to the quality of your code (ruff, mypy and type annotations). Our pre-commits will help you with that.
In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
Be sure to read the Airflow Coding style.
Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
Apache Airflow is a community-driven project and together we are making it better 🚀.
In case of doubts contact the developers at:
Mailing List: dev@airflow.apache.org
Slack: https://s.apache.org/airflow-slack

…eeze 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.

dataengineervishal · 2025-08-14T21:32:51Z

@potiuk This is my first PR. I’ve fixed the lint errors and confirmed that all checks are now passing. Could you please review and approve for merge? Let me know if there’s anything else I should address.

boring-cyborg · 2025-08-15T02:05:09Z

Awesome work, congrats on your first merged pull request! You are invited to check our Issue Tracker for additional contributions.

…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

github-actions · 2025-08-15T02:05:56Z

Backport successfully created: v3-0-test

Status	Branch	Result
✅	v3-0-test

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (apache#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

boring-cyborgBot added area:dev-tools backport-to-v3-0-test labels Aug 14, 2025

potiuk approved these changes Aug 14, 2025
View reviewed changes

dataengineervishal added 2 commits August 15, 2025 02:33

fix: address lint and doc build issues
5711847

dataengineervishal force-pushed the docs/fix-breeze-template-notfound-not branch from 614b9b9 to 5711847Compare August 14, 2025 21:03

dataengineervishal requested a review from potiuk August 14, 2025 21:06

Lee-W approved these changes Aug 15, 2025
View reviewed changes

Lee-W merged commit 83f0dc5 into apache:mainAug 15, 2025
46 checks passed

github-actionsBot pushed a commit that referenced this pull request Aug 15, 2025
[v3-0-test] docs: Guide for resolving UI TemplateNotFound in Breeze s…
1b30b92
…etup (#54521) (cherry picked from commit 83f0dc5) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

Lee-W pushed a commit that referenced this pull request Aug 15, 2025
[v3-0-test] docs: Guide for resolving UI TemplateNotFound in Breeze s…
006cf23
…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>

kaxil pushed a commit that referenced this pull request Aug 18, 2025
[v3-0-test] docs: Guide for resolving UI TemplateNotFound in Breeze s…
d10509a
…etup (#54521) (#54530) Co-authored-by: Vishal <69051998+dataengineervishal@users.noreply.github.com>