Add option to disable ssr globally in config

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## UNRELEASED
 
+## [0.14.0] - 2024-09-25
+
+### Added
+
+-   Added the option to disable SSR through a config variable [Issue 144](https://github.com/woutdp/live_svelte/issues/144)
+
 ### Changed
 
 -   Updated :nodejs to `3.1`

README.md

@@ -472,12 +472,21 @@ In theses cases you can turn off SSR.
 
 #### Disabling SSR
 
-SSR is enabled by default when you install LiveSvelte. If you don't want to use Server-Side Rendering for Svelte, you have 2 options:
+SSR is enabled by default when you install LiveSvelte. If you don't want to use Server-Side Rendering for Svelte, you can disable it in the following ways:
 
 ##### Globally
 
 If you don't want to use SSR on any component you can disable it globally.
-This will automatically be the case if you don't include the `NodeJS` supervisor in the `application.ex` file
+
+There are 2 ways of doing this
+- Don't include the `NodeJS` supervisor in the `application.ex` file
+or
+- Add `ssr: false` to the `live_svelte` config in your `config.exs` file like so:
+
+```elixir
+config :live_svelte,
+  ssr: false
+```
 
 ##### Component
 

config/config.exs

@@ -1,7 +1,8 @@
 import Config
 
 config :live_svelte,
-  ssr_module: LiveSvelte.SSR.NodeJS
+  ssr_module: LiveSvelte.SSR.NodeJS,
+  ssr: true
 
 if Mix.env() == :dev do
   esbuild = fn args ->

example_project/config/config.exs

@@ -49,6 +49,10 @@ config :logger, :console,
 # Use Jason for JSON parsing in Phoenix
 config :phoenix, :json_library, Jason
 
+# Configure live_svelte
+config :live_svelte,
+  ssr: true
+
 # Import environment specific config. This must remain at the bottom
 # of this file so it overrides the configuration defined above.
 import_config "#{config_env()}.exs"

lib/component.ex

@@ -64,14 +64,15 @@ defmodule LiveSvelte do
   def svelte(assigns) do
     init = assigns.__changed__ == nil
     dead = assigns.socket == nil or not LiveView.connected?(assigns.socket)
+    ssr_active = Application.get_env(:live_svelte, :ssr, true)
 
     slots =
       assigns
       |> Slots.rendered_slot_map()
       |> Slots.js_process()
 
     ssr_code =
-      if init and dead and assigns.ssr do
+      if init and dead and ssr_active and assigns.ssr do
         try do
           props =
             Map.merge(