Start BETA - Tracking #2863

SeanCassiere · 2024-11-26T03:10:03Z

SeanCassiere
Nov 26, 2024
Maintainer

Tracking any important changes for TanStack Start during the BETA period.

If you are coming from the ALPHA of TanStack Start, you can see all the breaking changes that were made here - #2403

SeanCassiere · 2024-11-27T08:28:24Z

SeanCassiere
Nov 27, 2024
Maintainer Author

v1.83.0 - Changed export variable renamed from `Route` to `APIRoute`

Important

Breaking change for users of API Routes

We've changed the name of the variable that's picked up by the API handler for routes that have API Routes configured.

// app/routes/api.foo.tsx
import { createAPIFileRoute } from '@tanstack/start/api'

- export const Route = createAPIFileRoute('/api/foo')({
+ export const APIRoute = createAPIFileRoute('/api/foo')({
    GET: () => {
        return new Response('Hello world')
    }
})

0 replies

schiller-manuel · 2025-02-14T22:24:01Z

schiller-manuel
Feb 14, 2025
Maintainer

v1.105.0 - `<HeadContent>` replaces `<Meta>`

<Meta> was replaced by <HeadContent>.
<Scripts> moved into @tanstack/react-router

This is non-breaking, but <Meta> is now deprecated and will be removed later.

 // app/routes/__root.tsx
-import { createRootRoute } from '@tanstack/react-router'
+import { createRootRoute, HeadContent, Scripts } from '@tanstack/react-router'
 import { Outlet } from '@tanstack/react-router'
-import { Meta, Scripts } from '@tanstack/start'
 import * as React from 'react'
 
 export const Route = createRootRoute({
@@ -231,7 +230,7 @@ function RootDocument({ children }: { children: React.ReactNode }) {
   return (
     <html>
       <head>
-        <Meta />
+        <HeadContent />
       </head>
       <body>
         {children}

0 replies

schiller-manuel · 2025-02-25T21:21:20Z

schiller-manuel
Feb 25, 2025
Maintainer

v1.111.10 - renamed package from `@tanstack/start` to `@tanstack/react-start`

@tanstack/start was renamed to @tanstack/react-start.

This is non-breaking, but @tanstack/start is now deprecated and will be removed later.

0 replies

SeanCassiere · 2025-03-11T08:08:56Z

SeanCassiere
Mar 11, 2025
Maintainer Author

⏱️ coming soon, moving from `./app` to `./src`

As part of our Vite + Nitro migration, we'll be changing the default base app directory for TanStack Start, from ./app to ./src, which will be more Vite-native.

If you'd like to opt-in to this behaviour early, you can make these changes, to move from `./app` to `./src`.

Set tsr.appDirectory to ./src in your app.config.ts.

// app.config.ts
import { defineConfig } from '@tanstack/react-start/config'

export default defineConfig({
+	tsr: {
+		appDirectory: './src'
+	}
	// ...
})

If you are using path aliases, change the source from ./app to ./src in your tsconfig.json.

{
	"compilerOptions": {
		"paths": {
-			"~/*": ["app/*"]
+			"~/*": ["./src/*"]
		}
	}
}

If you are using TailwindCSS, change the content source from ./app to ./src in your tailwind.config.js

// tailwind.config.js
/** @type {import('tailwindcss').Config} */
export default {
-  content: ['./app/**/*.{js,jsx,ts,tsx}'],
+  content: ['./src/**/*.{js,jsx,ts,tsx}'],
}

Rename the app folder to src.

If you run into any issues, feel free to hop into our Discord server and create a question in the #start-questions channel.

To give you the best 'new user experience', we've already updated the examples (#3712). Documentation changes, shouldn't be too far behind.

This post will be deleted/hidden, once the Vite + Nitro migration has been completed and merged in.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Start BETA - Tracking #2863

{{title}}

Replies: 4 comments

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

Select a reply

Start BETA - Tracking #2863

SeanCassiere Nov 26, 2024 Maintainer

Replies: 4 comments

SeanCassiere Nov 27, 2024 Maintainer Author

v1.83.0 - Changed export variable renamed from Route to APIRoute

schiller-manuel Feb 14, 2025 Maintainer

v1.105.0 - <HeadContent> replaces <Meta>

schiller-manuel Feb 25, 2025 Maintainer

v1.111.10 - renamed package from @tanstack/start to @tanstack/react-start

SeanCassiere Mar 11, 2025 Maintainer Author

⏱️ coming soon, moving from ./app to ./src

SeanCassiere
Nov 26, 2024
Maintainer

SeanCassiere
Nov 27, 2024
Maintainer Author

v1.83.0 - Changed export variable renamed from `Route` to `APIRoute`

schiller-manuel
Feb 14, 2025
Maintainer

v1.105.0 - `<HeadContent>` replaces `<Meta>`

schiller-manuel
Feb 25, 2025
Maintainer

v1.111.10 - renamed package from `@tanstack/start` to `@tanstack/react-start`

SeanCassiere
Mar 11, 2025
Maintainer Author

⏱️ coming soon, moving from `./app` to `./src`