From ca4d9af913c8f88abda8a0f216fc7eb642b1648e Mon Sep 17 00:00:00 2001 From: Thomas Perale Date: Fri, 29 Aug 2025 12:33:26 +0200 Subject: [PATCH] docs/migrating.adoc: document static JS library This patch adds information on how to provides static JS libraries in Buildroot with the release of the 2025.08.x version. Because the way JavaScript project development is working the chances that your project is using the same version of the buildroot package, and you provide this library from `/var/www` to your users is actually really low ... If you want to bundle JavaScript libraries in your project you should probably either use a cdn, handle the package version and location of your choice in your external or overlay, or just bundle it in your assets from a NPM workflow to benefit from some minifications from your bundler. Historically many of those JavaScript libraries were added in the 2010 eras where it could make sense for them to be part of Buildroot. Most of them are also way outdated/not maintained. For more informations see https://elinux.org/Buildroot:DeveloperDaysELCE2025 Signed-off-by: Thomas Perale Signed-off-by: Thomas Petazzoni --- docs/manual/migrating.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/manual/migrating.adoc b/docs/manual/migrating.adoc index 9ded46bfa2..eabaaa80a7 100644 --- a/docs/manual/migrating.adoc +++ b/docs/manual/migrating.adoc @@ -228,3 +228,17 @@ your kernel or use an alternative network manager. In 2025.11, the +FOO_INSTALL_BINS+ variable for golang packages is no longer supported; the list of binaries to install is automatically derived from the +FOO_BUILD_TARGETS+ variable. + +[[migrating-js-libs]] +=== Migration to 2026.02 + +Starting 2025.08, JavaScript libraries that were just copied to `/var/www` on +the target filesystem are not part of the Buildroot packages. +If you want to provide such libraries either: + +- Use a CDN to target the library version of your choice. +- Serve it by adding the package to your external and installing the content to + the destination of your choice +- Serve it by adding the library to your overlay. +- Install the libraries from your project with NPM and bundle with a JavaScript + bundler.