[Documentation Request] Extending the HTML template

[Hebilicious]

Describe the feature

How to extend the HTML template should be explained clearly in the docs, with example for the most common things.

We should document how to use the following Nitro hooks at the same time.

export default defineNitroPlugin((nitroApp) => {
  nitroApp.hooks.hook('render:html', (html, { event }) => { console.log({ html }) })
  nitroApp.hooks.hook('render:response', (response, { event }) => { console.log(response) })
})

This would fix #14195

Additional information

• Would you be willing to help implement this feature?
• Could this feature be implemented as a module?

Final checks

• Read the contribution guide.
• Check existing discussions and issues.

[danielroe]

A PR would be very welcome ❤️ 🙏

[huang-julien]

BTW is it me or don't we have any types for nitro hooks ?

[danielroe]

They exist in nitro. Worth checking the cause if the types aren't flowing through

[Lehoczky]

They exist in nitro. Worth checking the cause if the types aren't flowing through

There is a TODO comment for this in nitro's source code:

export interface NitroApp {
  h3App: H3App;
  router: Router;
  // TODO: Type hooks and allow extending
  hooks: Hookable;
  localCall: ReturnType<typeof createCall>;
  localFetch: ReturnType<typeof createLocalFetch>;
}

https://github.com/unjs/nitro/blob/88b4e11854c6a84c764bf64329f8e50a946b03b8/src/runtime/app.ts#L29