Which JS files in the @nue folder are required

[yerlaser]

When I run bun build --production along with the app files I get the @nue folder with the following content:

╭───┬─────────────────────┬──────────╮
│ # │        name         │   size   │
├───┼─────────────────────┼──────────┤
│ 0 │ @nue/app-router.js  │    980 B │
│ 1 │ @nue/diffdom.js     │ 30.0 KiB │
│ 2 │ @nue/mount.js       │  1.1 KiB │
│ 3 │ @nue/nue.js         │  5.0 KiB │
│ 4 │ @nue/page-router.js │  1.7 KiB │
╰───┴─────────────────────┴──────────╯

My app is currently very simple and by some research I found out that diffdom, app-router and page-router aren't being referenced and so I deleted them and as expected the app continued to run.

Why are these files in the production output, will they be needed as I add features to the app?

[nobkd]

Not completely sure about everything, but these are my thoughts (some have documentation links where you can gather more information):

app-router is used to navigate on SPA pages
page-router is used when you activate page_router: true in your site.yaml (could some problems currently, see #141)
diffdom is probably used by app- and/or page-router to only update changed DOM parts
mount is needed to mount reactive components / islands on your page (if any)
nue is probably the component handling and logic (also manual mounting?)

As far as I can see, you won't need any of it if you don't use reactive components, SPA pages, or turn on the page router

[yerlaser]

Thank you, that's useful. I hope there will be some tree shaking, though, so that what's not needed should be left out of production output.

[tipiirai]

By default Nue doesn't include JavaScript at all. Those files are only included on if they are explicitly configured to do so. For example, if you add reactive components to some folder, Nue automatically detects them and includes both mount.js, nue.js, and the required components. ie. there is tree shaking: only stuff that is needed is included. Generally Nue pages use less HTML, CSS, and JavaScript than any other framework.

[tipiirai]

Noticed that diff-dom was incorrectly added to the production folder. Which is now fixed. Thank you @yerlaser for pointing out!

[yerlaser]

That was the biggest size contributor!
Thank you very much!

[tipiirai]

Happy to see that people still care about size! Seems to be a lost art in the age of React and Tailwind.