From c76c8d27889c323ca041a04a37a99957d26d2c44 Mon Sep 17 00:00:00 2001
From: Shishant Biswas <shishantbiswas@gmail.com>
Date: Sun, 15 Mar 2026 00:23:19 +0530
Subject: [PATCH] docs(solid-start): add JSDoc comments to adapter functions

---
 .../adapter/solid-start/solid-start.adapter.ts | 11 ++++++++++-
 examples/solid/src/routes/index.tsx            | 18 +++++++++---------
 examples/solid/src/routes/user.tsx             |  2 +-
 3 files changed, 20 insertions(+), 11 deletions(-)

diff --git a/app/src/adapter/solid-start/solid-start.adapter.ts b/app/src/adapter/solid-start/solid-start.adapter.ts
index 37c6fe1..8ada7f6 100644
--- a/app/src/adapter/solid-start/solid-start.adapter.ts
+++ b/app/src/adapter/solid-start/solid-start.adapter.ts
@@ -3,6 +3,11 @@ import { createRuntimeApp, type RuntimeBkndConfig } from "bknd/adapter";
 export type SolidStartEnv = NodeJS.ProcessEnv;
 export type SolidStartBkndConfig<Env = SolidStartEnv> = RuntimeBkndConfig<Env>;
 
+/**
+ * Get bknd app instance
+ * @param config - bknd configuration
+ * @param args - environment variables
+ */
 export async function getApp<Env = SolidStartEnv>(
    config: SolidStartBkndConfig<Env>,
    args: Env = process.env as Env,
@@ -10,7 +15,11 @@ export async function getApp<Env = SolidStartEnv>(
    return await createRuntimeApp(config, args);
 }
 
-
+/**
+ * Create middleware handler for Solid Start
+ * @param config - bknd configuration
+ * @param args - environment variables
+ */
 export function serve<Env = SolidStartEnv>(
    config: SolidStartBkndConfig<Env> = {},
    args: Env = process.env as Env,
diff --git a/examples/solid/src/routes/index.tsx b/examples/solid/src/routes/index.tsx
index 3423bf0..b83a991 100644
--- a/examples/solid/src/routes/index.tsx
+++ b/examples/solid/src/routes/index.tsx
@@ -1,5 +1,5 @@
 import type { DB } from "bknd";
-import { Suspense } from "solid-js";
+import { For, Suspense } from "solid-js";
 import { Footer } from "~/components/Footer";
 import { List } from "~/components/List";
 import { getApi } from "~/lib/bknd";
@@ -58,9 +58,9 @@ export default function Home() {
   return (
     <div class="grid grid-rows-[20px_1fr_20px] items-center justify-items-center min-h-screen p-8 pb-20 gap-16 sm:p-20 ">
       <main class="flex flex-col gap-8 row-start-2 items-center sm:items-start">
-        <div class="flex flex-row items-center ">
+        <div class="flex flex-row items-center justify-evenly min-w-full">
           <img
-            class="dark:invert size-18"
+            class="size-18"
             src="/solid.svg"
             alt="Solid Start logo"
           />
@@ -86,15 +86,14 @@ export default function Home() {
                 </div>
               )}
               <div class="flex flex-col gap-3">
-                {data()?.todos?.
-                  splice(0, data()?.limit ?? 0)
-                  .map((todo) => (
+                <For each={data()?.todos?.splice(0, data()?.limit ?? 0)}>
+                  {(todo) => (
                     <div class="flex flex-row">
                       <div class="flex flex-row flex-grow items-center gap-3 ml-1">
                         <input
                           type="checkbox"
                           class="flex-shrink-0 cursor-pointer"
-                          checked={!!todo.done}
+                          checked={Boolean(todo.done)}
                           onChange={async () => {
                             await updateTodo(todo);
                           }}
@@ -113,7 +112,8 @@ export default function Home() {
                         ❌
                       </button>
                     </div>
-                  ))}
+                  )}
+                </For>
               </div>
               <form
                 class="flex flex-row w-full gap-3 mt-2"
@@ -124,7 +124,7 @@ export default function Home() {
                   type="text"
                   name="title"
                   placeholder="New todo"
-                  class="py-2 px-4 flex flex-grow rounded-sm bg-foreground/10 focus:bg-foreground/20 transition-colors outline-none"
+                  class="py-2 px-4 flex flex-grow rounded-sm bg-black/5 focus:bg-black/10 dark:bg-white/5 dark:focus:bg-white/10 transition-colors outline-none"
                 />
                 <button type="submit" class="cursor-pointer" disabled={submission.pending}>
                   {submission.pending ? "Adding..." : "Add"}
diff --git a/examples/solid/src/routes/user.tsx b/examples/solid/src/routes/user.tsx
index b5be690..a093212 100644
--- a/examples/solid/src/routes/user.tsx
+++ b/examples/solid/src/routes/user.tsx
@@ -43,7 +43,7 @@ export default function Home() {
   return (
     <div class="grid grid-rows-[20px_1fr_20px] items-center justify-items-center min-h-screen p-8 pb-20 gap-16 sm:p-20">
       <main class="flex flex-col gap-8 row-start-2 items-center sm:items-start">
-        <div class="flex flex-row items-center ">
+        <div class="flex flex-row items-center justify-evenly min-w-full">
           <img
             class="dark:invert size-18"
             src="/solid.svg"