@c9up/photon

Frontend rendering engine for the Ream framework. SSR + client hydration for React, Vue, and Svelte.

Usage

import { Ignitor } from '@c9up/ream'
import { PhotonMiddleware } from '@c9up/photon'

const photon = new PhotonMiddleware({
  framework: 'react',
  entryClient: 'resources/app.tsx',
  entryServer: 'resources/ssr.tsx',
})

const app = new Ignitor({ port: 3000 })
  .httpServer()
  .use(photon.middleware())
  .routes((router) => {
    router.get('/dashboard', async ({ response, photon }) => {
      const result = await photon.render('Dashboard', { user: { name: 'Alice' } })
      response.status(result.status)
      for (const [k, v] of Object.entries(result.headers)) {
        response.header(k, v)
      }
      response.send(result.html)
    })
  })

Features

• Server-side rendering (SSR) with client hydration — in production (the built SSR module). In dev mode SSR is not yet wired: boot() returns early and render() emits an empty <div id="app"></div> shell the client hydrates (client-only render — the Vite dev-server SSR proxy is not implemented yet).
• SPA navigation via X-Photon header (JSON props only)
• React (≥18), Vue (≥3), Svelte (≥5) framework support
• Page data safely escaped in HTML
• Production build with manifest-based asset loading

License

MIT