---

name: sveltekit-remote-functions

IMPORTANT: Keep description on ONE line for Claude Code compatibility

prettier-ignore

description: SvelteKit remote functions guidance. Use for command(), query(), form() patterns in .remote.ts files.

SvelteKit Remote Functions

Quick Start

File naming: *.remote.ts for remote function files

Which function? One-time action → command() | Repeated reads → query() | Forms → form()

Example

Copy// actions.remote.ts
import { command } from "$app/server";
import * as v from "valibot";

export const delete_user = command(
  v.object({ id: v.string() }),
  async ({ id }) => {
    await db.users.delete(id);
    return { success: true };
  }
);

// Call from client: await delete_user({ id: '123' });

Reference Files

• references/remote-functions.md - Complete guide with all patterns

Notes

• Remote functions execute on server when called from browser
• Args/returns must be JSON-serializable
• Schema validation via StandardSchemaV1 (Valibot/Zod)
• getRequestEvent() available for cookies/headers access
• In components: Use <svelte:boundary> + {@const await} (no flicker)
• Refresh queries: Call query().refresh() - updates without flicker
• Last verified: 2025-12-24