Spike Preact SSR

Easily render preact components to HTML

Note: This project is in early development, and versioning is a little different. Read this for more details.

Installation

yarn add spike-preact-ssr

Usage

Let's say you have some preact components in a folder under assets/js/pages, like this:

export default ({ foo }) => {
  return (<p>Hello there! Foo is {foo}</p>)
}

...and you want to prerender these as HTML. You'd just add the plugin to spike, and tell it where your component(s) are, and how to map them to an output path as such:

const path = require('path')
const PreactSSR = require('spike-preact-ssr')

module.exports = {
  // ...
  plugins: [
    new PreactSSR({
      pages: 'assets/js/pages/*.js', // globstar syntax optional
      props: { foo: 'bar' }, // props to pass to root component
      output: (relativePath) => path.basename(relativePath).replace(/\.js$/, '.html') // by default it will map to its current location and just replace .js with .html
    })
  ]
  // ...
}

That's it! Run spike, and you'll see some nice pretty html rendered out as you wanted. If you have interactive components, you can then run them from JS as well and it will work just like normal server side rendering.

License & Contributing

• Details on the license can be found here
• Details on running tests and contributing can be found here