create-ruvyxa 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thirawat Sinlapasomsak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# create-ruvyxa
+
+Create a new Ruvyxa app from the minimal starter template.
+
+## Usage
+
+```bash
+npm create ruvyxa@latest my-app
+cd my-app
+pnpm install
+pnpm dev
+```
+
+The package includes the starter template during `prepack`, so it works after being installed from npm.

package/bin/create-ruvyxa.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { createRuvyxaApp } from "../dist/index.js"
+
+const target = process.argv[2] ?? "my-ruvyxa-app"
+
+await createRuvyxaApp(target)
+console.log(`Created ${target}`)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare function createRuvyxaApp(targetDir: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtE"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { cp, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export async function createRuvyxaApp(targetDir) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packagedTemplateDir = resolve(here, "../template/minimal");
+    const monorepoTemplateDir = resolve(here, "../../../templates/minimal");
+    const templateDir = existsSync(packagedTemplateDir) ? packagedTemplateDir : monorepoTemplateDir;
+    await mkdir(targetDir, { recursive: true });
+    await cp(templateDir, targetDir, { recursive: true, force: false, errorOnExist: true });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACpD,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;IAChE,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAA;IACvE,MAAM,WAAW,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAA;IAE/F,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;AACzF,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "create-ruvyxa",
+  "version": "1.0.0",
+  "description": "Spin up a production-minded Ruvyxa app with file routing, Tailwind CSS, actions, and agent-ready project docs.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-ruvyxa": "./bin/create-ruvyxa.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "template",
+    "README.md"
+  ],
+  "keywords": [
+    "create",
+    "starter",
+    "template",
+    "ruvyxa",
+    "typescript",
+    "react"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thirawat27/ruvyxa.git",
+    "directory": "packages/create-ruvyxa"
+  },
+  "bugs": {
+    "url": "https://github.com/thirawat27/ruvyxa/issues"
+  },
+  "homepage": "https://github.com/thirawat27/ruvyxa#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "format": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/template/minimal/.env.example

@@ -0,0 +1,2 @@
+RUVYXA_PUBLIC_APP_NAME=Ruvyxa
+DATABASE_URL=postgres://user:password@localhost:5432/ruvyxa

package/template/minimal/AGENTS.md

@@ -0,0 +1,30 @@
+# Ruvyxa App Agent Guide
+
+This is a Ruvyxa application.
+
+## App Structure
+
+- `app/` contains file-based routes.
+- `app/page.tsx` is the root page.
+- `app/layout.tsx` wraps nested pages.
+- `app/api/**/route.ts` contains API route handlers.
+- `public/` contains static assets copied into production output.
+- `ruvyxa.config.ts` configures the app.
+
+## Rules
+
+- Keep server-only code out of page/client imports.
+- Only expose client environment values with the `RUVYXA_PUBLIC_` prefix.
+- Put browser-only code in page/client components, not route handlers.
+- Run `ruvyxa analyze` before production builds when changing imports or routes.
+
+## Commands
+
+```bash
+pnpm install
+pnpm dev
+pnpm build
+pnpm start
+pnpm routes
+ruvyxa analyze
+```

package/template/minimal/CLAUDE.md

@@ -0,0 +1,10 @@
+# Claude Instructions
+
+Read `AGENTS.md` first. This project is a Ruvyxa app using file-based routing under `app/`.
+
+Before shipping changes:
+
+```bash
+ruvyxa analyze
+pnpm build
+```

package/template/minimal/app/about/page.tsx

@@ -0,0 +1,8 @@
+export default function About() {
+  return (
+    <main className="page">
+      <h1>About</h1>
+      <p>This page is discovered from app/about/page.tsx.</p>
+    </main>
+  )
+}

package/template/minimal/app/api/health/route.ts

@@ -0,0 +1,3 @@
+export function GET() {
+  return Response.json({ ok: true, framework: "Ruvyxa" })
+}

package/template/minimal/app/global.css

@@ -0,0 +1,76 @@
+@import "tailwindcss";
+
+@source "../app";
+@source "../components";
+
+:root {
+  color-scheme: light;
+  font-family:
+    Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  background: #f7f7f4;
+  color: #191b1f;
+}
+
+body {
+  margin: 0;
+}
+
+.page {
+  max-width: 760px;
+  margin: 0 auto;
+  padding: 80px 24px;
+}
+
+.logo {
+  display: block;
+  width: 132px;
+  height: 132px;
+  object-fit: contain;
+  margin-bottom: 28px;
+}
+
+h1 {
+  font-size: 48px;
+  line-height: 1;
+  margin: 0 0 16px;
+}
+
+p {
+  font-size: 18px;
+  line-height: 1.6;
+}
+
+a {
+  color: #0b6bcb;
+}
+
+nav,
+form,
+label {
+  display: grid;
+  gap: 12px;
+}
+
+nav {
+  margin-top: 24px;
+}
+
+form {
+  margin-top: 24px;
+  max-width: 420px;
+}
+
+input {
+  border: 1px solid #bfc7c2;
+  border-radius: 6px;
+  padding: 10px 12px;
+}
+
+button {
+  background: #191b1f;
+  border-radius: 6px;
+  color: #fff;
+  cursor: pointer;
+  font-weight: 700;
+  padding: 10px 14px;
+}

package/template/minimal/app/layout.tsx

@@ -0,0 +1,14 @@
+import "./global.css"
+
+export const meta = {
+  title: "Ruvyxa App",
+  description: "Full-stack TypeScript at Rust speed.",
+}
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}

package/template/minimal/app/page.tsx

@@ -0,0 +1,13 @@
+export default function Home() {
+  return (
+    <main className="page">
+      <img className="logo" src="/ruvyxa.png" alt="Ruvyxa logo" width="132" height="132" />
+      <h1>Hello Ruvyxa</h1>
+      <p>Full-stack TypeScript, powered by Rust.</p>
+      <nav>
+        <a href="/about">About</a>
+        <a href="/todos">Todos</a>
+      </nav>
+    </main>
+  )
+}

package/template/minimal/app/todos/action.ts

@@ -0,0 +1,21 @@
+import { action } from "ruvyxa/server"
+
+export const createTodo = action
+  .input({
+    parse(value: unknown) {
+      if (!value || typeof value !== "object" || !("title" in value)) {
+        throw new Error("Todo title is required")
+      }
+
+      const title = String(value.title).trim()
+      if (!title) {
+        throw new Error("Todo title is required")
+      }
+
+      return { title }
+    },
+  })
+  .handler(async ({ input, invalidate }) => {
+    invalidate("todos")
+    return { title: input.title, completed: false }
+  })

package/template/minimal/app/todos/page.tsx

@@ -0,0 +1,15 @@
+export default function TodosPage() {
+  return (
+    <main className="page">
+      <h1>Todos</h1>
+      <p>Server actions live in action.ts next to the page.</p>
+      <form method="post" action="/__ruvyxa/action?path=/todos&name=createTodo">
+        <label>
+          <span>Title</span>
+          <input name="title" defaultValue="Ship Ruvyxa" />
+        </label>
+        <button type="submit">Create todo</button>
+      </form>
+    </main>
+  )
+}

package/template/minimal/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "my-ruvyxa-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "ruvyxa dev",
+    "build": "ruvyxa build",
+    "start": "ruvyxa start",
+    "routes": "ruvyxa routes",
+    "analyze": "ruvyxa analyze",
+    "parity": "ruvyxa test:parity"
+  },
+  "dependencies": {
+    "ruvyxa": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.1.17"
+  },
+  "devDependencies": {
+    "@tailwindcss/cli": "^4.1.17",
+    "typescript": "^5.9.3"
+  }
+}

package/template/minimal/ruvyxa.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from "ruvyxa/config"
+
+export default defineConfig({
+  appDir: "app",
+  outDir: ".ruvyxa",
+  runtime: "node",
+  react: true,
+  server: {
+    port: 3000,
+    host: "localhost",
+  },
+  debug: {
+    overlay: true,
+    traces: true,
+  },
+})

package/template/minimal/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./.ruvyxa/tsconfig.json",
+  "compilerOptions": {
+    "strict": true
+  },
+  "include": ["app", "components", "server", "ruvyxa.config.ts"]
+}