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.