create-evikit 2.2.2

package/CNAME

@@ -0,0 +1 @@
+evikit.js.org

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright (C) 2026 by Denys Nykula <nykula@ukr.net>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/bin/create-evikit.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import ownPackage from "../package.json" with { type: "json" };
+import { template } from "../src/routes/api/server.js";
+
+const ownRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const name = process.argv[2];
+if (!name || !name[0] || /^[/-]/.test(name[0])) {
+  console.log("Try: npx create-evikit my-app");
+  process.exit(1);
+}
+
+const target = resolve(process.cwd(), name);
+if (existsSync(target)) {
+  mkdirSync(target, { recursive: true });
+}
+for (const file of [
+  ...template,
+  ".gitignore",
+  "eslint.config.js",
+  "tsconfig.json",
+]) {
+  const path = join(target, file);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(
+    path,
+    readFileSync(join(ownRoot, file), "utf8").replace(
+      /<link\s+href="\/node_modules\/[^"]+.css"\s+media="[^"]+"\s+rel="stylesheet"\s+\/>\s+/g,
+      "",
+    ),
+  );
+}
+
+// ---
+
+writeFileSync(
+  join(target, "src/lib/index.js"),
+  `
+import acceptLanguage from "accept-language";
+
+export function acceptLanguages() {
+  acceptLanguage.languages(["en"]);
+}
+`.trimStart(),
+);
+
+// ---
+
+writeFileSync(
+  join(target, "src/routes/api/types.js"),
+  `
+import { object, string } from "valibot";
+
+export const HomeGet = {
+  input: object({ lang: string() }),
+  outputs: { 200: object({ name: string(), version: string() }) },
+};
+`.trimStart(),
+);
+
+// ---
+
+writeFileSync(
+  join(target, "src/routes/api/server.js"),
+  `
+import { endpoint, json } from "evikit/server";
+
+import pkg from "../../../package.json" with { type: "json" };
+import { HomeGet } from "./types.js";
+
+export const HomeServer = {
+  get: endpoint(HomeGet, async () =>
+    json({ name: pkg.name, version: pkg.version }),
+  ),
+};
+`.trimStart(),
+);
+
+// ---
+
+writeFileSync(
+  join(target, "src/routes/page.js"),
+  `
+import { a, h1, main, p, useApi, useI18n } from "evikit";
+import { useTitle } from "hoofd/preact";
+
+import { HomeGet } from "./api/types.js";
+
+export function HomePage() {
+  const i18n = useI18n();
+  const { data } = useApi(HomeGet);
+  const title = data?.name || i18n.gettext("Loading...");
+  useTitle(title);
+
+  return main(
+    { class: "p-8" },
+    h1({ class: "text-xl" }, title),
+    data ? p({ class: "my-2" }, "v" + data.version) : undefined,
+    a({ class: "link", href: "/todo" }, i18n.gettext("Todos")),
+  );
+}
+`.trimStart(),
+);
+
+// ---
+
+writeFileSync(
+  join(target, "index.css"),
+  `
+@import "tailwindcss";
+@plugin "daisyui";
+`.trimStart(),
+);
+
+// ---
+
+writeFileSync(
+  join(target, ".env"),
+  `
+ORIGIN=http://localhost:8000
+PORT=8000
+`.trimStart(),
+);
+
+// ---
+
+const { allowScripts, dependencies, devDependencies, scripts } = ownPackage;
+/* eslint-disable perfectionist/sort-objects */
+const pkg = {
+  name,
+  version: "0.1.0",
+  private: true,
+  scripts: {
+    dev: scripts.dev,
+    build: scripts.build,
+    start: scripts.start,
+    extract: scripts.extract,
+    format: scripts.format,
+    lint: scripts.lint,
+    test: "node --test --test-concurrency=1",
+  },
+  type: "module",
+  dependencies: {
+    "accept-language": dependencies["accept-language"],
+    classnames: dependencies.classnames,
+    evikit: dependencies.evikit,
+    express: dependencies.express,
+    "file-type": dependencies["file-type"],
+    hoofd: dependencies.hoofd,
+    preact: dependencies.preact,
+    "preact-iso": dependencies["preact-iso"],
+    "swagger-ui-express": dependencies["swagger-ui-express"],
+    valibot: dependencies.valibot,
+  },
+  devDependencies: {
+    "@eslint/compat": devDependencies["@eslint/compat"],
+    "@eslint/js": devDependencies["@eslint/js"],
+    "@preact/preset-vite": devDependencies["@preact/preset-vite"],
+    "@tailwindcss/vite": devDependencies["@tailwindcss/vite"],
+    "@types/express": devDependencies["@types/express"],
+    "@types/node": devDependencies["@types/node"],
+    "@types/swagger-ui-express": devDependencies["@types/swagger-ui-express"],
+    "cross-env": devDependencies["cross-env"],
+    daisyui: devDependencies.daisyui,
+    eslint: devDependencies.eslint,
+    "eslint-config-prettier": devDependencies["eslint-config-prettier"],
+    "eslint-plugin-perfectionist":
+      devDependencies["eslint-plugin-perfectionist"],
+    globals: devDependencies.globals,
+    prettier: devDependencies.prettier,
+    typescript: devDependencies.typescript,
+    "typescript-eslint": devDependencies["typescript-eslint"],
+    vite: devDependencies.vite,
+    "vite-bundle-analyzer": devDependencies["vite-bundle-analyzer"],
+  },
+  allowScripts,
+};
+/* eslint-enable perfectionist/sort-objects */
+writeFileSync(
+  join(target, "package.json"),
+  JSON.stringify(pkg, null, 2) + "\n",
+);
+execSync("npm install", { cwd: target, stdio: "inherit" });
+
+console.log("\n✅ Project created successfully!\n");
+console.log("Next steps:");
+console.log(`  cd ${name}`);
+console.log(`  npm run dev\n`);
+console.log("Documentation: https://codeberg.org/nykula/evikit");

package/eslint.config.js

@@ -0,0 +1,22 @@
+import { includeIgnoreFile } from "@eslint/compat";
+import js from "@eslint/js";
+import prettier from "eslint-config-prettier/flat";
+import perfectionist from "eslint-plugin-perfectionist";
+import { defineConfig } from "eslint/config";
+import globals from "globals";
+import { fileURLToPath } from "node:url";
+import ts from "typescript-eslint";
+
+export default defineConfig(
+  includeIgnoreFile(fileURLToPath(new URL("./.gitignore", import.meta.url))),
+  js.configs.recommended,
+  ...ts.configs.strict,
+  ...ts.configs.stylistic,
+  perfectionist.configs["recommended-natural"],
+  prettier,
+  {
+    languageOptions: {
+      globals: { ...globals.browser, ...globals.node },
+    },
+  },
+);

package/index.css

@@ -0,0 +1,55 @@
+@import "tailwindcss";
+@plugin "daisyui";
+
+[lang="uk"] p {
+  text-wrap: balance;
+}
+
+p a:not([class]) {
+  color: #28f;
+  text-decoration: underline;
+}
+
+figcaption span,
+summary span {
+  opacity: 0.3333;
+}
+
+[class*="shj-lang-"] {
+  box-shadow: none !important;
+  font: inherit !important;
+}
+
+.shj-inline {
+  padding: 0 !important;
+}
+
+figure,
+details {
+  box-shadow: 0 0 1em rgba(0, 0, 0, 0.05);
+}
+
+nav a {
+  background-color: currentColor;
+  color: #fff;
+  border-radius: 1em;
+  box-shadow: 0 0 5px rgba(0, 0, 0, 0.05);
+  display: inline-block;
+  margin-bottom: 1em;
+  padding: 1em;
+}
+
+nav a:focus,
+nav a:hover {
+  opacity: 0.75;
+}
+
+nav a[href*="documentation"] {
+  background-color: #84f;
+  color: #fff;
+}
+
+nav a[href*="issues"] {
+  background-color: #7d8f;
+  color: #fff;
+}

package/index.html

@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="color-scheme" content="dark light" />
+    <link href="/index.css" rel="stylesheet" />
+    <link
+      href="/node_modules/@speed-highlight/core/dist/themes/default.css"
+      media="(prefers-color-scheme: light)"
+      rel="stylesheet"
+    />
+    <link
+      href="/node_modules/@speed-highlight/core/dist/themes/atom-dark.css"
+      media="(prefers-color-scheme: dark)"
+      rel="stylesheet"
+    />
+    <!--app-head-->
+  </head>
+  <body>
+    <div id="app"><!--app-html--></div>
+    <script prerender type="module" src="/src/app.js"></script>
+  </body>
+</html>

package/index.js

@@ -0,0 +1,19 @@
+import { listen, production } from "evikit/server";
+import express from "express";
+import { readFile } from "node:fs/promises";
+import swaggerUi from "swagger-ui-express";
+
+import { api } from "./src/api.js";
+import { prerender } from "./src/app.js";
+
+const app = express();
+app.use(api().onRequest);
+app.use("/openapi", swaggerUi.serve, swaggerUi.setup(api().openapi));
+app.use("/", express.static("./dist", { index: false, redirect: false }));
+app.use(
+  production({
+    html: await readFile("./dist/index.html", "utf-8"),
+    prerender,
+  }),
+);
+listen(app);

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-evikit",
+  "version": "2.2.2",
+  "type": "module",
+  "bin": "bin/create-evikit.js",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "tsc && vite build",
+    "start": "cross-env NODE_ENV=production node --env-file=.env index.js",
+    "extract": "evikit-extract",
+    "format": "prettier --write . && eslint --fix .",
+    "lint": "prettier --check . && eslint ."
+  },
+  "author": "Denys Nykula <nykula@ukr.net>",
+  "license": "0BSD",
+  "devDependencies": {
+    "@eslint/compat": "^2.1.0",
+    "@eslint/js": "^10.0.1",
+    "@preact/preset-vite": "^2.10.5",
+    "@tailwindcss/vite": "^4.3.2",
+    "@types/express": "^5.0.6",
+    "@types/node": "^26.1.0",
+    "@types/swagger-ui-express": "^4.1.8",
+    "cross-env": "^10.1.0",
+    "daisyui": "^5.6.14",
+    "eslint": "^10.6.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-perfectionist": "^5.10.0",
+    "globals": "^17.7.0",
+    "prettier": "^3.9.4",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.63.0",
+    "vite": "^8.1.3",
+    "vite-bundle-analyzer": "^1.3.8"
+  },
+  "dependencies": {
+    "@speed-highlight/core": "^1.2.17",
+    "accept-language": "^3.0.20",
+    "classnames": "^2.5.1",
+    "evikit": "^2.2.2",
+    "express": "^5.2.1",
+    "file-type": "^22.0.1",
+    "hoofd": "^1.7.3",
+    "preact": "^10.29.5",
+    "preact-iso": "^2.12.0",
+    "swagger-ui-express": "^5.0.1",
+    "valibot": "^1.4.2"
+  },
+  "allowScripts": {
+    "@scarf/scarf": false
+  }
+}

package/po/create-evikit.pot

@@ -0,0 +1,84 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR Denys Nykula <nykula@ukr.net>
+# This file is distributed under the same license as the create-evikit package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: create-evikit\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-07-07 23:06+0300\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"
+
+msgid "EviKit: Preact SSR framework for small web apps"
+msgstr ""
+
+msgid "Preact SSR framework."
+msgstr ""
+
+msgid "For small web apps hosted on a <b>VPS</b> or in local network."
+msgstr ""
+
+msgid ""
+"Standard modern <b>JavaScript</b>, no JSX or TS. <b>Forms</b> accessible "
+"when JS doesn't load. Automatic <b>Swagger</b> specification. First-class "
+"API input/output <b>validation</b>. Built-in <b>node:sqlite ORM</b>. Support "
+"for UI <b>translation</b> through .po files."
+msgstr ""
+
+msgid "Documentation"
+msgstr ""
+
+msgid "Report <b>issue</b>"
+msgstr ""
+
+msgid ""
+"See <a href=\"{todo}\">live demo</a> of the example code from below. Todos "
+"are deleted every 10 minutes."
+msgstr ""
+
+msgid "Quick start"
+msgstr ""
+
+msgid ""
+"There’s intentionally <b>not much API</b>. Documentation entirely fits in a "
+"long but straightforward <b>README</b>. Like the Django tutorial, it guides "
+"you through <b><a href=\"{documentation}\">writing an application</a></b> "
+"using all the primary features of the EviKit framework."
+msgstr ""
+
+msgid ""
+"<a href=\"{evikit}\"><b>Source code</b> at Codeberg</a> under <b>MIT</b> "
+"license"
+msgstr ""
+
+msgid "Discuss on <b>Fediverse</b>"
+msgstr ""
+
+msgid "%1 todo"
+msgid_plural "%1 todos"
+msgstr[0] ""
+msgstr[1] ""
+
+msgid "Todos"
+msgstr ""
+
+msgid "Text"
+msgstr ""
+
+msgid "Create todo"
+msgstr ""
+
+msgid "Back to plan"
+msgstr ""
+
+msgid "Done"
+msgstr ""

package/po/uk.po

@@ -0,0 +1,100 @@
+# Ukrainian translations for create-evikit package.
+# Copyright (C) 2026 Denys Nykula <nykula@ukr.net>
+# This file is distributed under the same license as the create-evikit package.
+# Denys Nykula <nykula@ukr.net>, 2026.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: create-evikit\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-07-07 23:06+0300\n"
+"PO-Revision-Date: 2026-07-07 23:07+0300\n"
+"Last-Translator: EMAIL@ADDRESS\n"
+"Language-Team: Ukrainian\n"
+"Language: uk\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
+"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
+"X-Generator: Poedit 3.9\n"
+
+msgid "EviKit: Preact SSR framework for small web apps"
+msgstr "EviKit: Preact SSR-фреймворк для невеликих вебзастосунків"
+
+msgid "Preact SSR framework."
+msgstr "Preact SSR-фреймворк."
+
+msgid "For small web apps hosted on a <b>VPS</b> or in local network."
+msgstr ""
+"Для невеликих вебзастосунків, розміщених на <b>VPS</b> чи в локальній мережі."
+
+msgid ""
+"Standard modern <b>JavaScript</b>, no JSX or TS. <b>Forms</b> accessible "
+"when JS doesn't load. Automatic <b>Swagger</b> specification. First-class "
+"API input/output <b>validation</b>. Built-in <b>node:sqlite ORM</b>. Support "
+"for UI <b>translation</b> through .po files."
+msgstr ""
+"Стандартний сучасний <b>JavaScript</b>, без JSX чи TS. <b>Форми</b> "
+"доступні, навіть коли JS не запускається. <b>Swagger</b>-специфікація "
+"генерується автоматично. <b>Валідація</b> введення-виведення API - з "
+"коробки. Вбудована <b>ORM</b> на основі <b>node:sqlite</b>. Підтримується "
+"<b>переклад</b> інтерфейсу через .po-файли."
+
+msgid "Documentation"
+msgstr "Документація"
+
+msgid "Report <b>issue</b>"
+msgstr "Повідомити про <b>ваду</b>"
+
+msgid ""
+"See <a href=\"{todo}\">live demo</a> of the example code from below. Todos "
+"are deleted every 10 minutes."
+msgstr ""
+"Перегляньте <a href=\"{todo}\">живе демо</a> коду зразків, наведених унизу. "
+"Завдання видаляються кожні 10 хвилин."
+
+msgid "Quick start"
+msgstr "Швидкий початок"
+
+msgid ""
+"There’s intentionally <b>not much API</b>. Documentation entirely fits in a "
+"long but straightforward <b>README</b>. Like the Django tutorial, it guides "
+"you through <b><a href=\"{documentation}\">writing an application</a></b> "
+"using all the primary features of the EviKit framework."
+msgstr ""
+"<b>API навмисне небагато</b>. Документація повністю вміщається в довгий, але "
+"послідовний <b>README</b>-файл. Подібно до посібника Django, він містить "
+"покрокові інструкції з <b><a href=\"{documentation}\">написання застосунка</"
+"a></b>, що використовує всі основні функції фреймворка EviKit."
+
+msgid ""
+"<a href=\"{evikit}\"><b>Source code</b> at Codeberg</a> under <b>MIT</b> "
+"license"
+msgstr ""
+"<a href=\"{evikit}\"><b>Вихідний код</b> на Codeberg</a> на умовах ліцензії "
+"<b>MIT</b>"
+
+msgid "Discuss on <b>Fediverse</b>"
+msgstr "Обговорити в <b>Fediverse</b>"
+
+msgid "%1 todo"
+msgid_plural "%1 todos"
+msgstr[0] "%1 завдання"
+msgstr[1] "%1 завдання"
+msgstr[2] "%1 завдань"
+
+msgid "Todos"
+msgstr "Завдання"
+
+msgid "Text"
+msgstr "Текст"
+
+msgid "Create todo"
+msgstr "Створити завдання"
+
+msgid "Back to plan"
+msgstr "Назад до плану"
+
+msgid "Done"
+msgstr "Готово"

package/src/api.js

@@ -0,0 +1,16 @@
+import { route, router } from "evikit/server";
+
+import pkg from "../package.json" with { type: "json" };
+import { acceptLanguages } from "./lib/index.js";
+import { HomeServer } from "./routes/api/server.js";
+import { TodoServer } from "./routes/api/todo/server.js";
+
+acceptLanguages();
+
+export function api() {
+  return router(
+    { pkg },
+    route("/api", HomeServer),
+    route("/api/todo", TodoServer),
+  );
+}

package/src/app.js

@@ -0,0 +1,24 @@
+import { hydrate, Router, ssr } from "evikit";
+import { h } from "preact";
+import { Route } from "preact-iso";
+
+import { acceptLanguages } from "./lib/index.js";
+import { HomePage } from "./routes/page.js";
+import { TodoPage } from "./routes/todo/page.js";
+
+acceptLanguages();
+
+/** @param {any} data */
+export const prerender = (data) => ssr(App, data);
+
+/** @param {{ dehydratedState?: any, i18n: any }} props */
+export function App(props) {
+  return h(
+    Router,
+    props,
+    h(Route, { component: HomePage, path: "/" }),
+    h(Route, { component: TodoPage, path: "/todo" }),
+  );
+}
+
+hydrate(App, "#app");

package/src/lib/db/index.js

@@ -0,0 +1,19 @@
+import { sqlite } from "evikit/sqlite";
+
+import pkg from "../../../package.json" with { type: "json" };
+import * as schema from "./schema.js";
+
+export const db = sqlite({ pkg, schema });
+
+if (
+  process.env["npm_command"] == "start" ||
+  process.env["npm_lifecycle_event"] == "dev"
+) {
+  setInterval(() => {
+    db.Todo.delete({
+      text: db.Todo.select()
+        .filter(({ createdAt }) => createdAt < Date.now() - 10 * 60e3)
+        .map(({ text }) => text),
+    });
+  }, 1000);
+}

package/src/lib/db/schema.js

@@ -0,0 +1,8 @@
+import { primary } from "evikit";
+import { integer, number, object, optional, pipe, string } from "valibot";
+
+export const Todo = object({
+  createdAt: pipe(number(), integer()),
+  doneAt: optional(pipe(number(), integer())),
+  text: pipe(string(), primary()),
+});

package/src/lib/index.js

@@ -0,0 +1,5 @@
+import acceptLanguage from "accept-language";
+
+export function acceptLanguages() {
+  acceptLanguage.languages(["en", "uk"]);
+}

package/src/routes/api/server.js

@@ -0,0 +1,29 @@
+import { endpoint, json } from "evikit/server";
+import { readFile } from "node:fs/promises";
+
+import { HomeGet } from "./types.js";
+
+export const template = [
+  "src/lib/db/schema.js",
+  "src/routes/api/todo/types.js",
+  "src/routes/api/todo/server.js",
+  "src/routes/todo/page.js",
+  "src/api.js",
+  "src/app.js",
+  "index.js",
+  "vite.config.js",
+  "src/lib/db/index.js",
+  "index.html",
+];
+
+export const HomeServer = {
+  get: endpoint(HomeGet, async () =>
+    json({
+      File: Object.fromEntries(
+        await Promise.all(
+          template.map(async (path) => [path, await readFile(path, "utf8")]),
+        ),
+      ),
+    }),
+  ),
+};

package/src/routes/api/todo/server.js

@@ -0,0 +1,21 @@
+import { endpoint, json, redirect } from "evikit/server";
+
+import { db } from "../../../lib/db/index.js";
+import { TodoGet, TodoPost } from "./types.js";
+
+export const TodoServer = {
+  get: endpoint(TodoGet, async () => json({ Todo: db.Todo.select() })),
+
+  post: endpoint(TodoPost, async ({ input }) => {
+    const todo = db.Todo.select().find(({ text }) => text == input.text);
+    if (todo) {
+      db.Todo.update({
+        set: { doneAt: todo.doneAt ? undefined : Date.now() },
+        where: { text: todo.text },
+      });
+    } else {
+      db.Todo.upsert({ createdAt: Date.now(), text: input.text });
+    }
+    return redirect("/todo", 302);
+  }),
+};

package/src/routes/api/todo/types.js

@@ -0,0 +1,13 @@
+import { array, object, string } from "valibot";
+
+import * as schema from "../../../lib/db/schema.js";
+
+export const TodoGet = {
+  input: object({ lang: string() }),
+  outputs: { 200: object({ Todo: array(schema.Todo) }) },
+};
+
+export const TodoPost = {
+  input: object({ lang: string(), text: string() }),
+  outputs: { 302: string(), 400: string() },
+};

package/src/routes/api/types.js

@@ -0,0 +1,6 @@
+import { object, record, string } from "valibot";
+
+export const HomeGet = {
+  input: object({ lang: string() }),
+  outputs: { 200: object({ File: record(string(), string()) }) },
+};

package/src/routes/page.js

@@ -0,0 +1,260 @@
+import { highlightAll } from "@speed-highlight/core";
+import { a, b, div, figure, h1, main, p, span, useApi, useI18n } from "evikit";
+import { useMeta, useTitle } from "hoofd/preact";
+import { h } from "preact";
+import { useEffect } from "preact/hooks";
+
+import { HomeGet } from "./api/types.js";
+
+export function HomePage() {
+  const i18n = useI18n();
+  const { data } = useApi(HomeGet);
+  useTitle(i18n.gettext("EviKit: Preact SSR framework for small web apps"));
+  useMeta({
+    content:
+      "Standard modern JavaScript, no JSX or TS. Forms accessible when JS doesn't load. Automatic Swagger specification. First-class API input/output validation. Built-in node:sqlite ORM. Support for UI translation through .po files.",
+    name: "description",
+  });
+  useEffect(() => {
+    highlightAll();
+  }, [JSON.stringify(data?.File)]);
+
+  return main(
+    { class: "max-w-5xl mx-auto p-8" },
+    h1(
+      { class: "mb-4 text-xl lg:text-3xl lg:text-center" },
+      "EviKit: ",
+      b(null, i18n.gettext("Preact SSR framework.")),
+      h("br", null),
+      span({
+        class: "mt-0 text-base lg:text-sm",
+        ...sanitize(
+          i18n.gettext(
+            "For small web apps hosted on a <b>VPS</b> or in local network.",
+          ),
+        ),
+      }),
+    ),
+
+    p({
+      class: "lg:text-center",
+      ...sanitize(
+        i18n.gettext(
+          "Standard modern <b>JavaScript</b>, no JSX or TS. <b>Forms</b> accessible when JS doesn't load. Automatic <b>Swagger</b> specification. First-class API input/output <b>validation</b>. Built-in <b>node:sqlite ORM</b>. Support for UI <b>translation</b> through .po files.",
+        ),
+      ),
+    }),
+
+    h(
+      "nav",
+      { class: "gap-4 grid grid-cols-2 max-w-lg mx-auto mt-6 text-center" },
+
+      a(
+        { href: "https://codeberg.org/nykula/evikit#documentation" },
+        b(null, i18n.gettext("Documentation")),
+        " (v2)",
+      ),
+
+      a({
+        href: "https://codeberg.org/nykula/evikit/issues",
+        ...sanitize(i18n.gettext("Report <b>issue</b>")),
+      }),
+    ),
+
+    p({
+      class: "mb-6 lg:text-center",
+      ...sanitize(
+        i18n
+          .gettext(
+            'See <a href="{todo}">live demo</a> of the example code from below. Todos are deleted every 10 minutes.',
+          )
+          .replace("{todo}", "/todo"),
+      ),
+    }),
+
+    h(
+      "blockquote",
+      {
+        class: "max-w-xs mx-auto mb-8 p-4 rounded-lg text-center",
+        style: {
+          background: "rgba(0, 0, 0, 0.025)",
+          border: "1px solid rgba(0, 0, 0, 0.05)",
+        },
+      },
+      p(null, b(null, i18n.gettext("Quick start"))),
+      h(
+        "pre",
+        null,
+        h(
+          "code",
+          { class: "!bg-transparent shj-lang-bash" },
+          `
+npm init evikit my-app
+cd my-app
+npm run dev
+`.trimStart(),
+        ),
+      ),
+    ),
+
+    div(
+      { class: "grid grid-cols-1 lg:grid-cols-2 gap-8 w-full" },
+      h(
+        Code,
+        { file: data?.File["src/lib/db/schema.js"], lang: "js" },
+        span(null, "src/lib/"),
+        b(null, "db/schema.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["src/routes/api/todo/types.js"], lang: "js" },
+        span(null, "src/routes/"),
+        b(null, "api/todo/types.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["src/routes/api/todo/server.js"], lang: "js" },
+        span(null, "src/routes/"),
+        b(null, "api/todo/server.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["src/routes/todo/page.js"], lang: "js" },
+        span(null, "src/routes/"),
+        b(null, "todo/page.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["src/api.js"], lang: "js", tag: "details" },
+        span(null, "src/"),
+        b(null, "api.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["src/app.js"], lang: "js", tag: "details" },
+        span(null, "src/"),
+        b(null, "app.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["index.js"], lang: "js", tag: "details" },
+        b(null, "index.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["vite.config.js"], lang: "js", tag: "details" },
+        b(null, "vite.config.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["src/lib/db/index.js"], lang: "js", tag: "details" },
+        span(null, "src/lib/"),
+        b(null, "db/index.js"),
+      ),
+
+      h(
+        Code,
+        { file: data?.File["index.html"], lang: "html", tag: "details" },
+        b(null, "index.html"),
+      ),
+    ),
+
+    h("hr", { class: "opacity-0" }),
+    h(
+      "blockquote",
+      {
+        class: "max-w-2xl mx-auto my-8 p-4 rounded-lg text-center",
+        style: {
+          background: "rgba(0, 0, 0, 0.025)",
+          border: "1px solid rgba(0, 0, 0, 0.05)",
+        },
+      },
+      p({
+        ...sanitize(
+          i18n
+            .gettext(
+              'There’s intentionally <b>not much API</b>. Documentation entirely fits in a long but straightforward <b>README</b>. Like the Django tutorial, it guides you through <b><a href="{documentation}">writing an application</a></b> using all the primary features of the EviKit framework.',
+            )
+            .replace(
+              "{documentation}",
+              "https://codeberg.org/nykula/evikit#documentation",
+            ),
+        ),
+      }),
+    ),
+
+    h("hr", { class: "opacity-0" }),
+    h(
+      "footer",
+      { class: "text-center" },
+      p(
+        { class: "mb-4" },
+        "Copyright © 2026 ",
+        a({ href: "https://libre.net.ua" }, "Denys Nykula"),
+      ),
+      p({
+        class: "mb-4",
+        ...sanitize(
+          i18n
+            .gettext(
+              '<a href="{evikit}"><b>Source code</b> at Codeberg</a> under <b>MIT</b> license',
+            )
+            .replace("{evikit}", "https://codeberg.org/nykula/evikit"),
+        ),
+      }),
+      p(
+        { class: "mb-4" },
+        a({
+          href: "https://programming.dev/post/52844785",
+          ...sanitize(i18n.gettext("Discuss on <b>Fediverse</b>")),
+        }),
+      ),
+    ),
+  );
+}
+
+/** @param {{ children?: any, lang: string, file: string | undefined, tag?: string }} props */
+function Code({ children, file, lang, tag }) {
+  const inner = h(
+    "pre",
+    { class: "mt-4 overflow-auto text-sm" },
+    h(
+      "code",
+      { class: `w-full shj-lang-${lang}` },
+      file
+        ?.replace(/.*EviKit.*\r?\n/g, "")
+        .replace(/\{[\s\S]*?\} from/g, (match) => match.replace(/\s+/g, " "))
+        .replace(/.*(HomeServer|acceptLanguage).*\r?\n/g, "")
+        .replace(/.*(HomePage|acceptLanguage).*\r?\n/g, "")
+        .replace(
+          /<link\s+href="\/node_modules\/[^"]+.css"\s+media="[^"]+"\s+rel="stylesheet"\s+\/>\s+/g,
+          "",
+        ),
+    ),
+  );
+  const style = "border-lg mb-4 mx-0 overflow-hidden p-4";
+  return tag == "details"
+    ? h("details", { class: style }, h("summary", null, children), inner)
+    : figure({ class: style }, h("figcaption", null, children), inner);
+}
+
+/** @param {string} html */
+function sanitize(html) {
+  return {
+    dangerouslySetInnerHTML: {
+      __html: html.replace(/<([^>]*)>/g, (match) =>
+        /^<\/?[a-z]+>$/.test(match) || /^<a href="[a-z:/.#]*">$/.test(match)
+          ? match
+          : "",
+      ),
+    },
+  };
+}

package/src/routes/todo/page.js

@@ -0,0 +1,55 @@
+import classNames from "classnames";
+import {
+  a,
+  button,
+  form,
+  input,
+  main,
+  p,
+  useApi,
+  useEnhance,
+  useI18n,
+} from "evikit";
+import { useMeta, useTitle } from "hoofd/preact";
+
+import { TodoGet, TodoPost } from "../api/todo/types.js";
+
+export function TodoPage() {
+  const { data } = useApi(TodoGet);
+  const { busy, onSubmit } = useEnhance(TodoPost);
+  const i18n = useI18n();
+  useTitle(
+    data?.Todo.length
+      ? i18n.ngettext("%1 todo", "%1 todos", data.Todo.length, data.Todo.length)
+      : i18n.gettext("Todos"),
+  );
+  useMeta({ content: "noindex", name: "robots" });
+
+  return main(
+    { class: "m-8" },
+    form(
+      { action: "/api/todo", method: "POST", onSubmit },
+      input({
+        class: "input",
+        name: "text",
+        placeholder: i18n.gettext("Text"),
+        required: true,
+      }),
+      button(
+        { class: classNames("btn", busy && "btn-disabled") },
+        i18n.gettext("Create todo"),
+      ),
+    ),
+    (data?.Todo || []).map(({ doneAt, text }) =>
+      form(
+        { action: "/api/todo", method: "POST", onSubmit },
+        button(
+          { class: classNames("btn", busy && "btn-disabled") },
+          doneAt ? i18n.gettext("Back to plan") : i18n.gettext("Done"),
+        ),
+        input({ class: "input", name: "text", readOnly: true, value: text }),
+      ),
+    ),
+    p({ class: "mt-4" }, a({ href: "/" }, "EviKit")),
+  );
+}

package/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "outDir": "dist",
+    "module": "nodenext",
+    "target": "esnext",
+    "types": [],
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitReturns": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+    "allowJs": true,
+    "checkJs": true,
+    "noEmit": true,
+    "esModuleInterop": true
+  }
+}

package/vite.config.js

@@ -0,0 +1,20 @@
+import preact from "@preact/preset-vite";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig } from "vite";
+import { analyzer } from "vite-bundle-analyzer";
+
+import { api } from "./src/api.js";
+
+export default defineConfig({
+  plugins: [
+    analyzer({ analyzerMode: "static" }),
+    {
+      configureServer(server) {
+        server.middlewares.use(api().onRequest);
+      },
+      name: "configure-server",
+    },
+    preact({ prerender: { enabled: true, renderTarget: "#app" } }),
+    tailwindcss(),
+  ],
+});