@pyreon/server

SSR handler, static site generation, and island architecture for Pyreon.

Install

bun add @pyreon/server

SSR

Create a request handler that renders your Pyreon app on the server:

import { createHandler } from "@pyreon/server"
import { App } from "./App"
import { routes } from "./routes"

const handler = createHandler({
  App,
  routes,
  template: await Bun.file("index.html").text(),
})

Bun.serve({ fetch: handler, port: 3000 })

SSG (Static Site Generation)

Pre-render pages to static HTML files:

import { createHandler, prerender } from "@pyreon/server"

const handler = createHandler({ App, routes })
const result = await prerender({
  handler,
  paths: ["/", "/about", "/blog"],
  outDir: "dist",
})
console.log(`Generated ${result.pages} pages in ${result.elapsed}ms`)

Islands

Render mostly-static pages with interactive islands that hydrate independently:

// Server
import { island } from "@pyreon/server"

const Counter = island(() => import("./Counter"), {
  name: "Counter",
  hydrate: "visible",  // load | idle | visible | media(query) | never
})

// Client entry
import { startClient, hydrateIslands } from "@pyreon/server/client"

// Full app hydration
startClient({ App, routes, container: "#app" })

// Or island-only hydration
hydrateIslands({
  Counter: () => import("./Counter"),
  Search: () => import("./Search"),
})

API

Server Exports (@pyreon/server)

• createHandler(options: HandlerOptions) -- create an SSR request handler
• prerender(options: PrerenderOptions) -- generate static HTML files
• island(loader, options: IslandOptions) -- define an island component
• processTemplate(template, data) -- inject rendered HTML into an HTML template
• buildScripts(data) -- generate script tags for hydration
• DEFAULT_TEMPLATE -- built-in HTML template

Client Exports (@pyreon/server/client)

• startClient(options: StartClientOptions) -- hydrate a full SSR app
• hydrateIslands(registry) -- hydrate island components on the page

Types

HandlerOptions, PrerenderOptions, PrerenderResult, IslandOptions, IslandMeta, HydrationStrategy, Middleware, MiddlewareContext, TemplateData, StartClientOptions