@deepraxis/app-template 0.0.0-stage → 0.1.0-dev.61eb886

package/template/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "praxis-app",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@cloudflare/vite-plugin": "^1",
+    "@vinext/cloudflare": "1.1.1",
+    "@vitejs/plugin-react": "6.1.2",
+    "@vitejs/plugin-rsc": "0.5.38",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "drizzle-orm": "^0.44.0",
+    "next": "15.5.25",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-server-dom-webpack": "^19.2.6",
+    "tailwind-merge": "^2.5.0",
+    "vinext": "1.2.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20250214.0",
+    "@types/bun": "1.3.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.0",
+    "typescript": "^5.0.0",
+    "vite": "^8",
+    "wrangler": "4.151.0"
+  }
+}

package/template/postcss.config.cjs

@@ -0,0 +1 @@
+module.exports = { plugins: { tailwindcss: {}, autoprefixer: {} } };

package/template/praxis.jsonc

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://deepraxis.com/schemas/praxis.json",
+  "kind": "application",
+  "name": "<app-name>",
+  // Secrets the app needs. "generate": praxis app deploy creates a random value on the first deploy
+  // and keeps it on every later deploy. Set your own with: praxis api application worker secret put …
+  "secrets": { "SESSION_SECRET": "generate" },
+  // praxis app deploy calls this path after deploying and fails the deploy unless it answers 2xx.
+  "healthcheck": "/api/health"
+}

package/template/tailwind.config.ts

@@ -0,0 +1,7 @@
+import type { Config } from "tailwindcss";
+
+export default {
+  content: ["./app/**/*.{ts,tsx}", "./components/**/*.{ts,tsx}"],
+  theme: { extend: {} },
+  plugins: [],
+} satisfies Config;

package/template/test/fake-d1.ts

@@ -0,0 +1,38 @@
+// A minimal D1 over bun:sqlite: just the surface lib/migrate.ts uses (prepare/bind/all/run and a transactional batch).
+import { Database } from "bun:sqlite";
+
+class Stmt {
+  constructor(readonly db: Database, readonly sql: string, readonly args: unknown[] = []) {}
+  bind(...args: unknown[]) {
+    return new Stmt(this.db, this.sql, args);
+  }
+  run() {
+    this.db.query(this.sql).run(...(this.args as any[]));
+    return { success: true };
+  }
+  async all<T>() {
+    return { results: this.db.query(this.sql).all(...(this.args as any[])) as T[] };
+  }
+}
+
+export function fakeD1(db = new Database(":memory:")) {
+  const log: string[] = [];
+  const d1 = {
+    prepare: (sql: string) => new Stmt(db, sql),
+    async batch(stmts: Stmt[]) {
+      db.run("BEGIN");
+      try {
+        for (const s of stmts) {
+          log.push(s.sql);
+          s.run();
+        }
+        db.run("COMMIT");
+      } catch (e) {
+        db.run("ROLLBACK");
+        throw e;
+      }
+      return stmts.map(() => ({ success: true }));
+    },
+  } as unknown as Pick<D1Database, "prepare" | "batch">;
+  return { d1, db, log };
+}

package/template/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "strict": true,
+    "noEmit": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "preserve",
+    "skipLibCheck": true,
+    "types": ["@cloudflare/workers-types", "vite/client"],
+    "baseUrl": ".",
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": ["**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "test"]
+}

package/template/vinext-plugins.ts

@@ -0,0 +1,77 @@
+
+// Vite plugins every vinext Worker build needs (console and its zones, pay, www). Build-time only:
+// vite configs import this; Worker code never does. Typed structurally so the package does not pin
+// a vite version (the apps run vite 8, the repo root hoists vite 7).
+import fs from "node:fs";
+import path from "node:path";
+
+interface BuildPlugin {
+  readonly name: string;
+  readonly enforce?: "pre" | "post";
+  renderChunk?(code: string): { code: string; map: null } | null;
+  options?<T extends object>(opts: T): T & { preserveEntrySignatures: "allow-extension" };
+  writeBundle?(output: { dir?: string }): void;
+  buildApp?: { order: "post"; handler(): void };
+}
+
+// rolldown's CJS interop helper emits `createRequire(import.meta.url)`, and workerd has no
+// import.meta.url inside a bundled module (deploy error 10021). Pin it to a constant URL.
+const workerdCreateRequire: BuildPlugin = {
+  name: "vinext-worker:workerd-create-require",
+  renderChunk(code) {
+    return code.includes("(import.meta.url)") ? { code: code.replaceAll("(import.meta.url)", '("file:///worker.js")'), map: null } : null;
+  },
+};
+
+// A Worker export that other chunks also import (instrumentWorker's telemetry-client, #5970) makes
+// rolldown move the entry body into _next/static/worker-entry-*.js behind a facade, but vinext's
+// root manifests are imported as "./__vinext_*.js" from that chunk: deploy error 10021, No such
+// module. Allowing the entry to export extra bindings keeps the entry body at the root (#6007).
+const workerEntryAtRoot: BuildPlugin = {
+  name: "vinext-worker:entry-at-root",
+  enforce: "post",
+  options(opts) {
+    return { ...opts, preserveEntrySignatures: "allow-extension" as const };
+  },
+};
+
+const RELATIVE_IMPORT = /(?:\bfrom\s*|\bimport\s*\(?\s*)["'](\.\.?\/[^"']+)["']/g;
+
+/** Relative module specifiers in the emitted JS that name no file: what Cloudflare refuses with 10021. */
+export function unresolvedModuleImports(dir: string): string[] {
+  const missing: string[] = [];
+  for (const entry of fs.readdirSync(dir, { recursive: true, withFileTypes: true })) {
+    if (!entry.isFile() || !/\.m?js$/.test(entry.name)) continue;
+    const file = path.join(entry.parentPath, entry.name);
+    for (const [, specifier] of fs.readFileSync(file, "utf8").matchAll(RELATIVE_IMPORT)) {
+      if (!fs.existsSync(path.resolve(path.dirname(file), specifier!))) missing.push(`${path.relative(dir, file)} → ${specifier}`);
+    }
+  }
+  return missing;
+}
+
+// Fail the build, not the deploy: Cloudflare only checks module resolution at upload time, after a
+// whole deploy layer has been scheduled behind it. vinext writes its manifests while later
+// environments build, so the check waits until every environment is done.
+function workerModulesResolve(): BuildPlugin {
+  const dirs = new Set<string>();
+  return {
+    name: "vinext-worker:modules-resolve",
+    enforce: "post",
+    writeBundle(output) {
+      if (output.dir) dirs.add(output.dir);
+    },
+    buildApp: {
+      order: "post",
+      handler() {
+        const missing = [...dirs].filter(dir => fs.existsSync(dir)).flatMap(dir => unresolvedModuleImports(dir).map(m => `${dir}: ${m}`));
+        if (missing.length > 0) throw new Error(`Worker bundle imports modules that were not emitted (Cloudflare 10021):\n${missing.join("\n")}`);
+      },
+    },
+  };
+}
+
+/** Put before vinext() in the plugin list. */
+export function vinextWorkerPlugins(): BuildPlugin[] {
+  return [workerdCreateRequire, workerEntryAtRoot, workerModulesResolve()];
+}

package/template/vite.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vite";
+import vinext from "vinext";
+import { cloudflare } from "@cloudflare/vite-plugin";
+import { vinextWorkerPlugins } from "./vinext-plugins";
+
+export default defineConfig({
+  plugins: [...vinextWorkerPlugins(), vinext(), cloudflare({ viteEnvironment: { name: "rsc", childEnvironments: ["ssr"] } })],
+});

package/template/wrangler.jsonc

@@ -0,0 +1,11 @@
+{
+  "name": "praxis-app",
+  "compatibility_date": "2025-04-01",
+  "compatibility_flags": ["nodejs_compat"],
+  "main": "vinext/server/app-router-entry",
+  "assets": { "binding": "ASSETS", "not_found_handling": "none" },
+  // The platform creates worker-owned resources for these bindings and ignores the ids.
+  "d1_databases": [{ "binding": "DB", "database_name": "app-db", "database_id": "local-only" }],
+  "r2_buckets": [{ "binding": "IMAGES", "bucket_name": "app-images" }]
+  // SESSION_SECRET (secret_text) is passed at deploy time and never written here.
+}