Skip to content
APERVEIL / DOCS / BLOCKS

Troubleshooting — Blocks

Fixes for Aperveil blocks: missing styles in Next.js, a plain-colour shader, the wrong typeface, or a form that does nothing.

08

Troubleshooting

The block's styles are missing in Next.js.
The entry file imports the block's stylesheet, and the Pages Router accepts global CSS in pages/_app.tsx only: move the import there.
The shader behind the block is a plain colour.
The browser has no WebGPU, or no usable GPU adapter; the block shows its own background colour, as designed.
The text uses a different font.
Load the block's typefaces in your page (see Typefaces).
The form does nothing.
Give it a handler (see Forms); without one it stays a preview.
Plain HTML shows nothing.
Open the page through a web server: modules do not load from file://.

Installing shaders on their own: see the guide for React, Vue, HTML, WordPress or Framer.