Skip to content

docs: index.html is generated into frontend/generated again - #6096

Open
mshabarov wants to merge 1 commit into
mainfrom
docs/generated-index-html
Open

mshabarov wants to merge 1 commit into
mainfrom
docs/generated-index-html

Conversation

@mshabarov

Copy link
Copy Markdown
Contributor

Documents vaadin/flow#24469

DX/docs · flow/configuration, flow/advanced · every project, and
anyone customizing the application shell

The default index.html moved back out of the project sources: it's
written to frontend/generated/, and an index.html in the
frontend folder only overrides it. A project needs no index.html
at all. Two pages still described the previous layout, one placing the
auto-generated file in frontend/ and the other in target/.

Risks:

  • ✅ Docs only. Reworded text, no new page and no moved anchor.

  • Rewrote callout 7 of the project layout in Source Control: the file
    is optional, the generated default lives in frontend/generated/
    and stays out of source control, and a project copy replaces it.

  • Changed the source-control bullet from "Can be committed if
    generated, should be if customized" to committing it only when the
    project has one of its own.

  • Corrected Modifying Bootstrap Page: the template is the project
    index.html where there is one and the generated default
    otherwise, and the default is written to frontend/generated/
    rather than to target/.

  • Said how to take control of a generated file: copy it from
    frontend/generated/ into frontend/.

🤖 Generated with Claude Code

A project index.html is optional: the default is written to
frontend/generated/ and a frontend/index.html only overrides it. The
pages still placed the generated file in frontend/ and in target/.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@peholmst peholmst added the target/v25.3 Automatically cherry-pick to the v25.3 branch label Sep 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

target/v25.3 Automatically cherry-pick to the v25.3 branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants