The Complete Production SOP: How to Deploy and Run SolidStart Fullstack Framework & Server Functions in Autonomous AI Agents

---
name: "solid-start-server-functions"
description: "Build fullstack web applications with SolidStart, file-based routing, and RPC server functions."
metadata:
  author: "SolidJS"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "write solidstart server function"
  - "solidstart file routing"
  - "cache server function solidstart"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# SolidStart Fullstack Framework & Server Functions

Configures SolidStart: file-based routing, server functions (server$ RPC), route loaders with cache(), form actions, server-side rendering (SSR), and deploying to Cloudflare Workers or Node.js.

## Execution SOP & Rules
1. Define server RPC: const getUser = server$(async (id: string) => { return await db.find(id); }).
2. Use createAsync(() => getUser(params.id)) to bind server promises to reactive client signals.
3. Handle form mutations using createServerAction$ for automatic invalidation.
4. Configure nitro presets in app.config.ts for desired deployment target (node, cloudflare, vercel).

import { defineConfig } from "@solidjs/start/config";

export default defineConfig({
  server: {
    preset: process.env.NITRO_PRESET || "node-server",
    prerender: {
      crawlLinks: true
    }
  }
});

import { createAsync, type RouteSectionProps } from "@solidjs/router";
import { cache } from "@solidjs/router";
import { server$ } from "@solidjs/start/server";
import { Show, Suspense } from "solid-js";

const getUser = cache(server$(async (userId: string) => {
  "use server";
  // Database calls execute exclusively on the server
  return { id: userId, name: `User ${userId}`, timestamp: new Date().toISOString() };
}), "users");

export const route = {
  load: ({ params }) => getUser(params.id)
};

export default function UserPage(props: RouteSectionProps) {
  const user = createAsync(() => getUser(props.params.id));

  return (
    <main class="p-6">
      <Suspense fallback={<p>Loading user profile...</p>}>
        <Show when={user()}>
          {(u) => (
            <div>
              <h1 class="text-xl font-bold">{u().name}</h1>
              <p class="text-sm text-gray-500">ID: {u().id}</p>
            </div>
          )}
        </Show>
      </Suspense>
    </main>
  );
}