add Xote CSR and SSR templates

Author: brnrdog

src/Templates.res

@@ -7,9 +7,11 @@ type t = {
 let basicTemplateName = "rescript-template-basic"
 let viteTemplateName = "rescript-template-vite"
 let nextjsTemplateName = "rescript-template-nextjs"
+let xoteTemplateName = "rescript-template-xote"
+let xoteSsrTemplateName = "rescript-template-xote-ssr"
 let templateNamePrefix = "rescript-template-"
 
-let supportedTemplateNames = ["vite", "nextjs", "basic"]
+let supportedTemplateNames = ["vite", "nextjs", "xote", "xote-ssr", "basic"]
 
 let getTemplateName = templateName => {
   let templateName = templateName->String.toLowerCase
@@ -30,6 +32,16 @@ let templates = [
     displayName: "Next.js",
     shortDescription: "Next.js 15 with static export and Tailwind 3",
   },
+  {
+    name: xoteTemplateName,
+    displayName: "Xote",
+    shortDescription: "Xote with Vite, signals and Tailwind 4 (CSR)",
+  },
+  {
+    name: xoteSsrTemplateName,
+    displayName: "Xote SSR",
+    shortDescription: "Xote with Vite, signals and Tailwind 4 (SSR)",
+  },
   {
     name: basicTemplateName,
     displayName: "Basic",

templates/rescript-template-xote-ssr/README.md

@@ -0,0 +1,70 @@
+# xote · SSR template
+
+A server-rendered starter for [xote](https://github.com/brnrdog/xote) apps. Renders HTML on a Node server, then hydrates on the client so reactivity takes over without re-rendering.
+
+## Stack
+
+- ReScript v12 (JSX transform: `XoteJSX`)
+- xote ^6.2 — uses `SSR.renderToString`, `SSRState`, and `Hydration`
+- rescript-signals
+- Vite 7 — runs in middleware mode for dev, and produces both client and SSR bundles for production
+- Tailwind CSS v4 (`@tailwindcss/vite`)
+
+## Layout
+
+```
+.
+├── index.html            # template with <!--app-html--> and <!--app-state--> placeholders
+├── server.mjs            # Node HTTP server (Vite middleware in dev, static + SSR in prod)
+├── vite.config.mjs
+├── rescript.json
+├── package.json
+└── src/
+    ├── styles.css
+    ├── Counter.res       # uses SSRState.signal so state survives hydration
+    ├── Page.res          # landing page composition
+    ├── App.res           # shared `view` thunk used by server and client
+    ├── Server.res        # exports render() → { html, stateScript }
+    └── Client.res        # imports styles, calls Hydration.hydrateById
+```
+
+## How it fits together
+
+1. `server.mjs` reads `index.html` and (in dev) hands it to Vite for asset/CSS transformation.
+2. It imports `Server.res` and calls `render()`, which uses `SSR.renderToString(App.view)` to produce HTML and `SSRState.generateScript()` to produce a `<script>` tag carrying initial signal values.
+3. The placeholders `<!--app-html-->` and `<!--app-state-->` in `index.html` are replaced with those two strings.
+4. The browser loads `Client.res.mjs`, which calls `Hydration.hydrateById(App.view, "root")`. xote walks the existing DOM, attaches reactive bindings, and reads back the serialized `SSRState` so signals start with the same values the server used.
+
+## Scripts
+
+| Script | What it does |
+| --- | --- |
+| `npm run res:dev` | Watches and compiles ReScript on save. Run during development. |
+| `npm run res:build` | One-shot ReScript build. |
+| `npm run res:clean` | Removes ReScript build artifacts. |
+| `npm run dev` | Runs `node server.mjs` with Vite in middleware mode. |
+| `npm run build` | Builds the client bundle and the SSR bundle. |
+| `npm run build:client` | Just the client bundle (`dist/client/`). |
+| `npm run build:ssr` | Just the SSR bundle (`dist/server/Server.res.js`). |
+| `npm run start` | Runs the server in production mode against the built bundles. |
+
+## Develop
+
+```bash
+npm install
+npm run res:dev
+# in another terminal:
+npm run dev
+```
+
+Open http://localhost:3000. The page is server-rendered (view source — the counter HTML is already there) and becomes interactive after hydration.
+
+## Build & run in production
+
+```bash
+npm run res:build
+npm run build
+npm run start
+```
+
+`server.mjs` defaults to port 3000; override with `PORT=8080 npm run start`.

templates/rescript-template-xote-ssr/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+lib
+*.res.mjs
+*.res.js
+.DS_Store

templates/rescript-template-xote-ssr/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>xote · SSR template</title>
+    <link rel="stylesheet" href="/src/styles.css" />
+  </head>
+  <body>
+    <div id="root"><!--app-html--></div>
+    <!--app-state-->
+    <script type="module" src="/src/Client.res.mjs"></script>
+  </body>
+</html>