Troubleshooting

Most issues come from plugin order, missing remote function configuration, or using server code from the browser.

The effect script is not transformed

Check the script tag and plugin order:

<script lang="ts" effect>
  import { Effect } from "effect";
</script>

plugins: [effect(), sveltekit()]

Also check that svelte.config.js includes the preprocessor:

import { preprocess } from "svelte-effect-runtime";

export default {
  preprocess: [preprocess()],
};

Enable SvelteKit remote functions:

const config = {
  kit: {
    experimental: {
      remoteFunctions: true,
    },
  },
};

Move database clients, secrets, cookies, and request-only services into remote handlers or server runtime layers.

Use plain fenced code blocks and Fumadocs JSX components. Avoid legacy directive fences.