From cd5d426e7eaab60fbcf651e0161a246a626bf543 Mon Sep 17 00:00:00 2001
From: "Ian J. MacIntosh" <ianjmacintosh@users.noreply.github.com>
Date: Sun, 10 Aug 2025 13:25:51 -0300
Subject: [PATCH] Update hosting.md with Railway instructions

I was puzzled why Railway wasn't starting a server, then realized TanStack Start doesn't define the start command by default
---
 docs/start/framework/react/hosting.md | 36 +++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/docs/start/framework/react/hosting.md b/docs/start/framework/react/hosting.md
index aff63011e7..1ccca16ef1 100644
--- a/docs/start/framework/react/hosting.md
+++ b/docs/start/framework/react/hosting.md
@@ -36,6 +36,7 @@ When a TanStack Start application is being deployed, the `target` value in the T
 - [`netlify`](#netlify): Deploy to Netlify
 - [`vercel`](#vercel): Deploy to Vercel
 - [`cloudflare-pages`](#cloudflare-pages): Deploy to Cloudflare Pages
+- [`railway`](#railway): Deploy to Railway
 - [`node-server`](#nodejs): Deploy to a Node.js server
 - [`bun`](#bun): Deploy to a Bun server
 - ... and more to come!
@@ -108,6 +109,41 @@ directory = "./.output/public"
 
 Deploy your application to Cloudflare Workers using their one-click deployment process, and you're ready to go!
 
+### Railway
+
+Railway automatically detects Build and Start commands when building and deploying to a service.
+
+Set the `target` value to `node-server` in your `vite.config.ts` file.
+
+```ts
+// vite.config.ts
+import { tanstackStart } from '@tanstack/react-start/plugin/vite'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [tanstackStart({ target: 'node-server' })],
+})
+```
+
+Ensure `build` and `start` npm scripts are present in your `package.json` file:
+
+```json
+    "build": "vite build",
+    "start": "node .output/server/index.mjs"
+```
+
+Then you can run the following command to build your application:
+
+```sh
+npm run build
+```
+
+You can start your application by running:
+
+```sh
+npm run start
+```
+
 ### Node.js
 
 Set the `target` value to `node-server` in your `vite.config.ts` file.