rari 0.1.3

package/dist/chunk-BLXvPPr8.js

@@ -0,0 +1,30 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __commonJS, __require, __toESM };

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/cli.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+import { getBinaryPath, getInstallationInstructions } from "./platform-CvSUcmnc.js";
+import process from "node:process";
+import { spawn } from "node:child_process";
+import colors from "picocolors";
+
+//#region src/cli.ts
+const [, , command, ...args] = process.argv;
+function logInfo(message) {
+	console.warn(`${colors.blue("info")} ${message}`);
+}
+function logSuccess(message) {
+	console.warn(`${colors.green("✓")} ${message}`);
+}
+function logError(message) {
+	console.error(`${colors.red("✗")} ${message}`);
+}
+function isRailwayEnvironment() {
+	return !!(process.env.RAILWAY_ENVIRONMENT || process.env.RAILWAY_PROJECT_ID || process.env.RAILWAY_SERVICE_ID);
+}
+function isRenderEnvironment() {
+	return !!(process.env.RENDER || process.env.RENDER_SERVICE_ID || process.env.RENDER_SERVICE_NAME);
+}
+function isPlatformEnvironment() {
+	return isRailwayEnvironment() || isRenderEnvironment();
+}
+function getPlatformName() {
+	if (isRailwayEnvironment()) return "Railway";
+	if (isRenderEnvironment()) return "Render";
+	return "local";
+}
+function getDeploymentConfig() {
+	const port = process.env.PORT || process.env.RSC_PORT || "3000";
+	const mode = process.env.NODE_ENV === "production" ? "production" : "development";
+	const host = isPlatformEnvironment() ? "0.0.0.0" : "127.0.0.1";
+	return {
+		port,
+		mode,
+		host
+	};
+}
+async function startRustServer() {
+	let binaryPath;
+	try {
+		binaryPath = getBinaryPath();
+	} catch {
+		logError("Failed to obtain Rari binary");
+		logError(getInstallationInstructions());
+		process.exit(1);
+	}
+	const { port, mode, host } = getDeploymentConfig();
+	if (isPlatformEnvironment()) {
+		const platformName = getPlatformName();
+		logInfo(`${platformName} environment detected`);
+		logInfo(`Starting Rari server for ${platformName} deployment...`);
+		logInfo(`Mode: ${mode}, Host: ${host}, Port: ${port}`);
+	} else logInfo(`starting Rari server in ${mode} mode on port ${port}...`);
+	logInfo(`using binary: ${binaryPath}`);
+	const args$1 = [
+		"--mode",
+		mode,
+		"--port",
+		port,
+		"--host",
+		host
+	];
+	const rustServer = spawn(binaryPath, args$1, {
+		stdio: "inherit",
+		cwd: process.cwd(),
+		env: {
+			...process.env,
+			RUST_LOG: process.env.RUST_LOG || "info"
+		}
+	});
+	const shutdown = () => {
+		logInfo("shutting down...");
+		rustServer.kill("SIGTERM");
+	};
+	process.on("SIGINT", shutdown);
+	process.on("SIGTERM", shutdown);
+	rustServer.on("error", (error) => {
+		logError(`Failed to start Rari server: ${error.message}`);
+		if (error.message.includes("ENOENT")) logError("Binary not found. Please ensure Rari is properly installed.");
+		process.exit(1);
+	});
+	rustServer.on("exit", (code, signal) => {
+		if (signal) logInfo(`server stopped by signal ${signal}`);
+		else if (code === 0) logSuccess("server stopped successfully");
+		else {
+			logError(`server exited with code ${code}`);
+			process.exit(code || 1);
+		}
+	});
+	return new Promise(() => {});
+}
+async function deployToRailway() {
+	logInfo("Setting up Railway deployment...");
+	if (isPlatformEnvironment()) {
+		logError(`Already running in ${getPlatformName()} environment. Use "rari start" instead.`);
+		process.exit(1);
+	}
+	const { createRailwayDeployment } = await import("./railway-XPhB0Ls4.js");
+	await createRailwayDeployment();
+}
+async function deployToRender() {
+	logInfo("Setting up Render deployment...");
+	if (isPlatformEnvironment()) {
+		logError(`Already running in ${getPlatformName()} environment. Use "rari start" instead.`);
+		process.exit(1);
+	}
+	const { createRenderDeployment } = await import("./render-BtA14L2P.js");
+	await createRenderDeployment();
+}
+async function main() {
+	switch (command) {
+		case "start":
+			await startRustServer();
+			break;
+		case "deploy":
+			if (args[0] === "railway") await deployToRailway();
+			else if (args[0] === "render") await deployToRender();
+			else {
+				logError("Unknown deployment target. Available: railway, render");
+				process.exit(1);
+			}
+			break;
+		case "help":
+		case "--help":
+		case "-h":
+			console.warn(`${colors.bold}Rari CLI${colors.reset}
+
+${colors.bold}Usage:${colors.reset}
+  ${colors.cyan}rari start${colors.reset}              Start the Rari server
+  ${colors.cyan}rari deploy railway${colors.reset}     Setup Railway deployment
+  ${colors.cyan}rari deploy render${colors.reset}      Setup Render deployment
+  ${colors.cyan}rari help${colors.reset}               Show this help message
+
+${colors.bold}Environment Variables:${colors.reset}
+  ${colors.yellow}PORT${colors.reset}                    Server port (default: 3000)
+  ${colors.yellow}RSC_PORT${colors.reset}               Alternative server port
+  ${colors.yellow}NODE_ENV${colors.reset}               Environment (development/production)
+  ${colors.yellow}RUST_LOG${colors.reset}               Rust logging level (default: info)
+
+${colors.bold}Examples:${colors.reset}
+  ${colors.gray}# Start development server on port 3000${colors.reset}
+  ${colors.cyan}rari start${colors.reset}
+
+  ${colors.gray}# Start production server on port 8080${colors.reset}
+  ${colors.cyan}PORT=8080 NODE_ENV=production rari start${colors.reset}
+
+  ${colors.gray}# Setup Railway deployment${colors.reset}
+  ${colors.cyan}rari deploy railway${colors.reset}
+
+  ${colors.gray}# Setup Render deployment${colors.reset}
+  ${colors.cyan}rari deploy render${colors.reset}
+
+  ${colors.gray}# Start with debug logging${colors.reset}
+  ${colors.cyan}RUST_LOG=debug rari start${colors.reset}
+
+${colors.bold}Deployment:${colors.reset}
+  ${colors.cyan}rari deploy railway${colors.reset}     Creates Railway deployment files
+  ${colors.cyan}rari deploy render${colors.reset}      Creates Render deployment files
+
+  Platform deployment automatically detects the environment and configures:
+  - Host binding (0.0.0.0 for platforms, 127.0.0.1 for local)
+  - Port from platform's PORT environment variable
+  - Production mode optimization
+
+${colors.bold}Binary Resolution:${colors.reset}
+  1. Platform-specific package (rari-{platform}-{arch})
+  2. Global binary in PATH
+  3. Install from source with Cargo
+
+${colors.bold}Notes:${colors.reset}
+  - Platform binary is automatically detected and used
+  - Platform deployment is automatically detected and configured
+  - Use Ctrl+C to stop the server gracefully
+
+`);
+			break;
+		default:
+			console.error(`${colors.bold}Unknown command:${colors.reset} ${command}`);
+			console.warn(`Run "${colors.cyan}rari help${colors.reset}" for available commands`);
+			process.exit(1);
+	}
+}
+main().catch((error) => {
+	logError(`CLI Error: ${error.message}`);
+	console.error(error);
+	process.exit(1);
+});
+
+//#endregion

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-BEWMJWMx.js";
+export { type ErrorBoundaryProps, type FileRouteInfo, HttpRuntimeClient, type LayoutProps, Link, type LinkProps, type LoadingProps, Navigate, type NavigationOptions, type NavigationState, Outlet, type PageComponent, type PageProps, RouteComponent as Route, type RouteGenerationOptions, type RouteMatch, type RouteMeta, type RouteParams, type Route as RouteType, type RouterConfig, type RouterContext, RouterProvider, type RouterProviderProps, Routes, type RuntimeClient, type SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter };

package/dist/client.js

@@ -0,0 +1,3 @@
+import { HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent, Routes, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, router_default, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CC4YQweh.js";
+
+export { HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent as Route, router_default as RouterProvider, Routes, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-BEWMJWMx.js";
+import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-MY0-nRif.js";
+export { ErrorBoundaryProps, FileRouteGenerator, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, RouteComponent as Route, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, Route as RouteType, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent, Routes, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, router_default, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CC4YQweh.js";
+import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-BvGV8m79.js";
+import "./server-build-DaBgiV55.js";
+
+export { FileRouteGenerator, HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent as Route, router_default as RouterProvider, Routes, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };

package/dist/platform-CvSUcmnc.js

@@ -0,0 +1,102 @@
+import { __require } from "./chunk-BLXvPPr8.js";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import process from "node:process";
+
+//#region src/platform.ts
+const SUPPORTED_PLATFORMS = {
+	"linux-x64": "rari-linux-x64",
+	"linux-arm64": "rari-linux-arm64",
+	"darwin-x64": "rari-darwin-x64",
+	"darwin-arm64": "rari-darwin-arm64",
+	"win32-x64": "rari-win32-x64"
+};
+function getPlatformInfo() {
+	const platform = process.platform;
+	const arch = process.arch;
+	let normalizedPlatform;
+	switch (platform) {
+		case "darwin":
+			normalizedPlatform = "darwin";
+			break;
+		case "linux":
+			normalizedPlatform = "linux";
+			break;
+		case "win32":
+			normalizedPlatform = "win32";
+			break;
+		default: throw new Error(`Unsupported platform: ${platform}. Rari supports Linux, macOS, and Windows.`);
+	}
+	let normalizedArch;
+	switch (arch) {
+		case "x64":
+			normalizedArch = "x64";
+			break;
+		case "arm64":
+			normalizedArch = "arm64";
+			break;
+		default: throw new Error(`Unsupported architecture: ${arch}. Rari supports x64 and ARM64.`);
+	}
+	const platformKey = `${normalizedPlatform}-${normalizedArch}`;
+	const packageName = SUPPORTED_PLATFORMS[platformKey];
+	if (!packageName) throw new Error(`Unsupported platform combination: ${normalizedPlatform}-${normalizedArch}. Supported platforms: ${Object.keys(SUPPORTED_PLATFORMS).join(", ")}`);
+	const binaryName = normalizedPlatform === "win32" ? "rari.exe" : "rari";
+	return {
+		platform: normalizedPlatform,
+		arch: normalizedArch,
+		packageName,
+		binaryName
+	};
+}
+function getBinaryPath() {
+	const { packageName, binaryName } = getPlatformInfo();
+	try {
+		let currentDir = process.cwd();
+		let workspaceRoot = null;
+		while (currentDir !== "/" && currentDir !== "") {
+			const packagesDir = join(currentDir, "packages");
+			if (existsSync(packagesDir)) {
+				workspaceRoot = currentDir;
+				break;
+			}
+			currentDir = join(currentDir, "..");
+		}
+		if (workspaceRoot) {
+			const packageDir = join(workspaceRoot, "packages", packageName);
+			const binaryPath = join(packageDir, "bin", binaryName);
+			if (existsSync(binaryPath)) return binaryPath;
+		}
+	} catch {}
+	try {
+		const packagePath = __require.resolve(`${packageName}/package.json`);
+		const packageDir = packagePath.replace("/package.json", "");
+		const binaryPath = join(packageDir, "bin", binaryName);
+		if (existsSync(binaryPath)) return binaryPath;
+		throw new Error(`Binary not found at ${binaryPath}`);
+	} catch {
+		throw new Error(`Failed to locate Rari binary for ${packageName}. Please ensure the platform package is installed: npm install ${packageName}`);
+	}
+}
+function getInstallationInstructions() {
+	const { packageName } = getPlatformInfo();
+	return `
+To install Rari for your platform, run:
+
+  npm install ${packageName}
+
+Or if you're using pnpm:
+
+  pnpm add ${packageName}
+
+Or if you're using yarn:
+
+  yarn add ${packageName}
+
+If you continue to have issues, you can also install from source:
+
+  cargo install --git https://github.com/rari-build/rari
+`;
+}
+
+//#endregion
+export { getBinaryPath, getInstallationInstructions, getPlatformInfo };

package/dist/platform-DIsErRFA.js

@@ -0,0 +1,3 @@
+import { getBinaryPath, getInstallationInstructions, getPlatformInfo } from "./platform-CvSUcmnc.js";
+
+export { getBinaryPath, getInstallationInstructions };

package/dist/railway-XPhB0Ls4.js

@@ -0,0 +1,216 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import process from "node:process";
+import colors from "picocolors";
+
+//#region src/deployment/railway.ts
+function logInfo(message) {
+	console.warn(`${colors.blue("info")} ${message}`);
+}
+function logSuccess(message) {
+	console.warn(`${colors.green("✓")} ${message}`);
+}
+function logError(message) {
+	console.error(`${colors.red("✗")} ${message}`);
+}
+function logWarning(message) {
+	console.warn(`${colors.yellow("⚠")} ${message}`);
+}
+async function createRailwayDeployment() {
+	const cwd = process.cwd();
+	logInfo("Creating Railway deployment configuration...");
+	const packageJsonPath = join(cwd, "package.json");
+	if (!existsSync(packageJsonPath)) {
+		logError("No package.json found. Please run this command from your project root.");
+		process.exit(1);
+	}
+	try {
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+		packageJson.scripts = packageJson.scripts || {};
+		if (packageJson.scripts.start && packageJson.scripts.start !== "rari start") {
+			logWarning(`Existing start script found: "${packageJson.scripts.start}"`);
+			logWarning("Backing up to start:original and replacing with \"rari start\"");
+			packageJson.scripts["start:original"] = packageJson.scripts.start;
+		}
+		packageJson.scripts.start = "rari start";
+		packageJson.scripts["start:local"] = "rari start";
+		packageJson.scripts["deploy:railway"] = "echo \"Push to GitHub and connect to Railway to deploy\"";
+		packageJson.engines = packageJson.engines || {};
+		if (!packageJson.engines.node) packageJson.engines.node = ">=20.0.0";
+		if (!packageJson.dependencies || !packageJson.dependencies.rari) {
+			logInfo("Adding rari dependency...");
+			packageJson.dependencies = packageJson.dependencies || {};
+			packageJson.dependencies.rari = "^0.1.0";
+		}
+		writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
+		logSuccess("Updated package.json for Railway deployment");
+	} catch (error) {
+		logError(`Failed to update package.json: ${error instanceof Error ? error.message : "Unknown error"}`);
+		process.exit(1);
+	}
+	const railwayConfig = {
+		$schema: "https://railway.app/railway.schema.json",
+		build: { builder: "NIXPACKS" },
+		deploy: {
+			startCommand: "npm start",
+			healthcheckPath: "/",
+			healthcheckTimeout: 300,
+			restartPolicyType: "ALWAYS"
+		},
+		environments: { production: { variables: {
+			NODE_ENV: "production",
+			RUST_LOG: "info"
+		} } }
+	};
+	const railwayJsonPath = join(cwd, "railway.json");
+	if (existsSync(railwayJsonPath)) {
+		logWarning("railway.json already exists, backing up to railway.json.backup");
+		const existingConfig = readFileSync(railwayJsonPath, "utf-8");
+		writeFileSync(join(cwd, "railway.json.backup"), existingConfig);
+	}
+	writeFileSync(railwayJsonPath, `${JSON.stringify(railwayConfig, null, 2)}\n`);
+	logSuccess("Created railway.json configuration");
+	const gitignorePath = join(cwd, ".gitignore");
+	const railwayGitignoreEntries = [
+		"",
+		"# Railway",
+		".railway/",
+		""
+	].join("\n");
+	if (existsSync(gitignorePath)) {
+		const gitignoreContent = readFileSync(gitignorePath, "utf-8");
+		if (!gitignoreContent.includes(".railway/")) {
+			writeFileSync(gitignorePath, gitignoreContent + railwayGitignoreEntries);
+			logSuccess("Updated .gitignore with Railway entries");
+		}
+	} else {
+		const defaultGitignore = `# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build outputs
+.rari/
+dist/
+
+# Environment variables
+.env
+.env.local
+.env.production
+
+# Railway
+.railway/
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Temporary files
+.tmp/
+tmp/
+`;
+		writeFileSync(gitignorePath, defaultGitignore);
+		logSuccess("Created .gitignore with Railway entries");
+	}
+	const readmePath = join(cwd, "README.md");
+	const railwayReadmeSection = `
+## 🚂 Deploy to Railway
+
+This Rari application is configured for Railway deployment.
+
+### Quick Deploy
+
+1. **Push to GitHub**:
+   \`\`\`bash
+   git add .
+   git commit -m "Add Railway deployment"
+   git push origin main
+   \`\`\`
+
+2. **Deploy to Railway**:
+   - Go to [railway.app](https://railway.app)
+   - Create new project → "Deploy from GitHub repo"
+   - Select your repository
+   - Click "Deploy Now"
+
+3. **Generate Domain**:
+   - In Railway dashboard → Settings → Networking
+   - Click "Generate Domain"
+   - Your app will be live! 🎉
+
+### Local Development
+
+\`\`\`bash
+# Development server
+npm run start:local
+
+# Production simulation
+npm start
+\`\`\`
+
+### Environment Variables
+
+Railway automatically provides:
+- \`PORT\` - Server port (Railway assigns this)
+- \`NODE_ENV=production\` - Production mode
+
+Optional variables you can set:
+- \`RUST_LOG=debug\` - Rust logging level
+
+---
+`;
+	if (existsSync(readmePath)) {
+		const readmeContent = readFileSync(readmePath, "utf-8");
+		if (!readmeContent.includes("Deploy to Railway")) {
+			writeFileSync(readmePath, readmeContent + railwayReadmeSection);
+			logSuccess("Updated README.md with Railway deployment instructions");
+		}
+	} else {
+		const defaultReadme = `# My Rari App
+
+A high-performance React Server Components application powered by Rari.
+${railwayReadmeSection}
+## Getting Started
+
+\`\`\`bash
+npm install
+npm start
+\`\`\`
+
+Visit [http://localhost:3000](http://localhost:3000) to see your app.
+`;
+		writeFileSync(readmePath, defaultReadme);
+		logSuccess("Created README.md with Railway deployment instructions");
+	}
+	console.warn("");
+	logSuccess("Railway deployment setup complete! 🎉");
+	console.warn("");
+	logInfo("Next steps:");
+	console.warn(`  1. ${colors.cyan("git add .")}`);
+	console.warn(`  2. ${colors.cyan("git commit -m \"Add Railway deployment\"")}`);
+	console.warn(`  3. ${colors.cyan("git push origin main")}`);
+	console.warn(`  4. Go to ${colors.cyan("https://railway.app")} and deploy from GitHub`);
+	console.warn("");
+	logInfo("Your Rari app will automatically:");
+	console.warn("  ✅ Detect Railway environment");
+	console.warn("  ✅ Bind to 0.0.0.0 (Railway requirement)");
+	console.warn("  ✅ Use Railway's PORT environment variable");
+	console.warn("  ✅ Run in production mode");
+	console.warn("  ✅ Download platform-specific Rari binary");
+	console.warn("");
+	logSuccess("Ready for deployment! 🚀");
+}
+
+//#endregion
+export { createRailwayDeployment };