Skip to content

Migrating from knockout-ssr

WARNING

Knuckles has taken knockout-ssr's place which is no longer maintained.

Welcome to Knuckles 🥳👊 We're glad to see you here!

A bunch of development tools made for Knockout by @tscpp, including knockout-lint, have been brought together to form the Knuckles toolkit! You can still choose to use each tool individually 😉

This guide will help you migrate your project to using Knuckles SSR.

Improvements

  • Stabillity: Stabillity of the tools have been improved by fixing bugs and refactoring code. Overall, the toolkit is much more stable than before and should be easier to use.
  • Conventions: Knuckles provides a universal syntax to provide hints. This makes adopting other tools much easier, but is still optional.

Breaking Changes

Linking View Models

Knuckles introduces an universal way to link view models to the decendants binding context using the 'with' hint.

html
<!-- ko ssr: './viewmodel.js' -->
<!-- ok with: default from './viewmodel.js' -->
  ...
<!-- /ok -->

Toggle Rendering

You can configure the SSR to render by default, or by explicitly enabling for certain parts of the project, like in the example below.

html
<!-- ok ssr: true -->
  ...
<!-- /ok -->

What's next?

If you have any questions, feel free to start a discussion.