FAQ

Resolved

background-attachment: fixed not supported on iOS ​

iOS has an issue preventing background-attachment: fixed from being used with background-size: cover. The Fixed Background Attachment Hack | CSS Tricks

Use ::before pseudo-element instead.

JavaScript heap out of memory ​

During SSG build (valaxy build --ssg), vite-ssg runs client build, server build, and page rendering in the same process. The Vite resolved config and plugin system from the build phase remain in memory, leaving limited heap space for the rendering phase.

Minimum memory requirement: --max-old-space-size=2304 (~2.3 GB)

bash
# Reproduce tests
pnpm test:space        # demo/yun
pnpm test:space:docs   # docs

Valaxy automatically adjusts SSG behavior based on V8’s heap_size_limit:

Heap Limitbeasties (Critical CSS)HTML minifyConcurrency
≤ 2.5 GBDisabledDisabled1
≤ 3.1 GBEnabledEnabled2
≤ 4.2 GBEnabledEnabled4
> 4.2 GBEnabledEnabled8+

If you encounter OOM in CI environments, increase the heap limit via NODE_OPTIONS:

bash
NODE_OPTIONS=--max-old-space-size=4096 pnpm build --ssg

Merge ​

Use defu.

Testing shows defu is faster than @fastify/deepmerge.

Merging a single config:

bash
# benchmark
@fastify/deepmerge x 605,343 ops/sec ±0.87% (96 runs sampled)
deepmerge x 20,312 ops/sec ±1.06% (92 runs sampled)
merge-deep x 83,167 ops/sec ±1.30% (94 runs sampled)
ts-deepmerge x 175,977 ops/sec ±0.57% (96 runs sampled)
deepmerge-ts x 174,973 ops/sec ±0.44% (93 runs sampled)
lodash.merge x 89,213 ops/sec ±0.70% (98 runs sampled)
To Be Continued.

Contributors