feat(netlify): Implement caching for static assets

[peerless-hero]

Description

This pull request configures long-term caching for assets in the /assets/ directory.

It adds a [[headers]] section to the netlify.toml file to set the Cache-Control header with a max-age of one year for all files under /assets/. This will improve website performance by leveraging browser and CDN caching.

Linked Issues

Additional context

Doc:
https://docs.netlify.com/routing/headers/
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control

[antfu]

Hmm, I am not so confident about that. The asset folder also contains JS bundles; even if it has a hash in the filename, I am still worried that a strong cache will cause some outdated JS to be executed that results in the site breaking.

[peerless-hero]

Hmm, I am not so confident about that. The asset folder also contains JS bundles; even if it has a hash in the filename, I am still worried that a strong cache will cause some outdated JS to be executed that results in the site breaking.

Thank you for your reply! I think we all share the same consensus that for any files packaged under the same project, as long as they carry the same hash value, the content must be identical. This is one of the main reasons we use content hashing.

For example, with a JavaScript file, let's say we have a file named app.abcdef123.js that previously had a bug. If we fix this bug and repackage it, the new file name will change to app.ghijkl456.js, which means the browser will request the new file instead of using the cached old version.

If the strong cache is set for too long, users might continue to use the old app.abcdef123.js file for a while, leading to them encountering the bug during use. However, due to the change in the hash value, users will automatically receive the updated version when accessing new content.

I’m curious if you have encountered similar situations or if you have any other potential scenarios in mind where things might go wrong.

[antfu]

Alright, I guess it would be fine. Thanks