Server-Side Rendering & Hydration
Methane wraps @lit-labs/ssr behind @methane-ui/ssr and ships adapters for Next.js, Nuxt, SvelteKit, Astro, and Angular so custom elements render on the server with Declarative Shadow DOM and hydrate cleanly on the client.
Hybrid Stylesheet Delivery
styles: 'linked'(Default): Emits a content-hashed<link rel="stylesheet" href="...">inside<template shadowrootmode="open">paired with a compact critical inline<style>shell to prevent FOUC and layout shift.styles: 'inline': Embeds the full component stylesheet inside<style>for emails, single-file HTML exports, and edge responses.- Client-only fallback:
@methane-ui/css/defined-guard.cssapplies a fail-open:not(:defined)reveal animation (nevervisibility: hidden), while pure-CSS layout tags (mth-stack,mth-grid,mth-flex,mth-container,mth-spacer) stay immediately visible atopacity: 1.
import { renderToString, transformHtmlDsd } from '@methane-ui/ssr';
const result = await transformHtmlDsd('<mth-button variant="solid">Save</mth-button>', {
styles: 'linked',
assetBase: '/assets/methane',
});import { renderNextHtml, withMethaneNextConfig } from '@methane-ui/ssr-next';
import { initNextHydration } from '@methane-ui/ssr-next/client';
export default withMethaneNextConfig({ reactStrictMode: true });
// Client ("use client"): initNextHydration();
// Server: await renderNextHtml(html, { styles: 'linked', assetBase: '/assets/methane' });import { createMethaneNitroPlugin, createMethaneNuxtConfig } from '@methane-ui/ssr-nuxt';
import { initNuxtHydration } from '@methane-ui/ssr-nuxt/client';
export default createMethaneNuxtConfig();
// Nitro plugin: export default createMethaneNitroPlugin({ styles: 'linked' });
// Client plugin: initNuxtHydration();import { serializeAngularSsrHtml, transformAngularSsrResponse } from '@methane-ui/ssr-angular';
import { provideMethaneHydration } from '@methane-ui/ssr-angular/client';
// Server: const { html } = await serializeAngularSsrHtml(ssrHtml, { styles: 'inline' });
// Client app.config.ts: provideMethaneHydration().initialize();import { createMethaneHandle, transformSvelteKitHtml } from '@methane-ui/ssr-sveltekit';
import { initSvelteKitHydration } from '@methane-ui/ssr-sveltekit/client';
// src/hooks.server.ts: export const handle = createMethaneHandle({ styles: 'inline' });
// src/hooks.client.ts: initSvelteKitHydration();