Skip to content

Commit 279b414

Browse files
NicolappsConvex, Inc.
authored andcommitted
Update TanStack Start quickstart (#41293)
GitOrigin-RevId: b462fa60ad7aef3a409b928ab287f8f3c96ab8de
1 parent 8c883ad commit 279b414

File tree

34 files changed

+2419
-990
lines changed

34 files changed

+2419
-990
lines changed

npm-packages/@convex-dev/react-query/package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,8 @@
3939
},
4040
"devDependencies": {
4141
"@tanstack/eslint-plugin-query": "^5.74.7",
42-
"@tanstack/react-query": "^5.62.0",
43-
"@tanstack/react-query-devtools": "^5.62.0",
42+
"@tanstack/react-query": "^5.90.2",
43+
"@tanstack/react-query-devtools": "^5.90.2",
4444
"@types/node": "^18.17.0",
4545
"@types/react": "^18.0.0",
4646
"@types/react-dom": "^18.0.0",

npm-packages/common/config/rush/common-versions.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,13 @@
7979
* The Convex CLI expects prettier for formatting generated code.
8080
*/
8181
"prettier": ["^3.0.0"],
82+
/**
83+
* Allow a newer version of Vite for TanStack Start projects.
84+
* Ideally we just update Vite to the latest version everywhere,
85+
* but some of our projects have dependencies that are not compatible
86+
* with Vite 7 so far.
87+
*/
88+
"vite": ["^7.1.7"],
8289
/**
8390
* These are for private-demos/tanstack-start to closely match
8491
* https://github.com/TanStack/router
@@ -105,6 +112,9 @@
105112
"@eslint/eslintrc": ["^3"],
106113
"eslint-config-next": ["15.2.3"],
107114

115+
// Keep the TanStack Start + Clerk demo on a pre-RC version since Clerk doesn’t support RC yet
116+
"@tanstack/react-start": ["1.120.11"],
117+
108118
/**
109119
* Until an upgrade to ESLint 9 is done
110120
*/

npm-packages/common/config/rush/pnpm-lock.yaml

Lines changed: 2134 additions & 673 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

npm-packages/demos/react-query/package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,8 @@
1515
"react-dom": "^18.0.0",
1616
"prettier": "3.6.2",
1717
"@convex-dev/react-query": "workspace:*",
18-
"@tanstack/react-query": "^5.62.0",
19-
"@tanstack/react-query-devtools": "^5.62.0"
18+
"@tanstack/react-query": "^5.90.2",
19+
"@tanstack/react-query-devtools": "^5.90.2"
2020
},
2121
"devDependencies": {
2222
"@types/babel__core": "^7.20.0",

npm-packages/docs/docs/quickstart/tanstack-start.mdx

Lines changed: 11 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,16 @@ sidebar_position: 200
77
---
88

99
import sampleData from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/sampleData.jsonl";
10-
import appRoutesRoot from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/app/routes/__root.tsx";
11-
import router from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/app/router.tsx";
12-
import index from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/app/routes/index.tsx";
10+
import appRoutesRoot from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/src/routes/__root.tsx";
11+
import router from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/src/router.tsx";
12+
import index from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/src/routes/index.tsx";
1313
import tasks from "!!raw-loader!@site/../private-demos/quickstarts/tanstack-start/convex/tasks.ts";
1414

15-
<Admonition type="caution" title="TanStack Start is in Beta">
15+
<Admonition type="caution" title="TanStack Start is in Release Candidate">
1616

1717
[TanStack Start](https://tanstack.com/start/latest) is a new React framework
18-
currently in beta. You can try it today but there are likely to be breaking
19-
changes before a stable release.
18+
currently in the Release Candidate stage. You can try it today but there might
19+
still be bug or issues.
2020

2121
</Admonition>
2222

@@ -40,29 +40,11 @@ Learn how to query data from Convex in a TanStack Start site.
4040
<StepByStep>
4141
<Step title="Create a TanStack Start site">
4242

43-
The TanStack team intends to release a CLI template starter soon, but until the
44-
official way to create a new TanStack Start site is to follow the TanStack Start
45-
[getting started](https://tanstack.com/router/latest/docs/framework/react/start/getting-started)
46-
guide.
47-
48-
Once you've finished you'll have a directory called myApp with a minimal
49-
TanStack Start app in it.
50-
51-
```sh
52-
.
53-
├── app/
54-
│ ├── routes/
55-
│ │ ├── `index.tsx`
56-
│ │ └── `__root.tsx`
57-
│ ├── `client.tsx`
58-
│ ├── `router.tsx`
59-
│ ├── `routeTree.gen.ts`
60-
│ └── `ssr.tsx`
61-
├── `.gitignore`
62-
├── `app.config.ts`
63-
├── `package.json`
64-
└── `tsconfig.json`
65-
```
43+
Create a TanStack Start app using the `create-start-app` command:
44+
45+
```sh
46+
npx create-start-app@latest
47+
```
6648

6749
</Step>
6850
<Step title="Install the Convex client and server library">

npm-packages/private-demos/quickstarts/tanstack-start/app.config.ts

Lines changed: 0 additions & 4 deletions
This file was deleted.

npm-packages/private-demos/quickstarts/tanstack-start/app/client.tsx

Lines changed: 0 additions & 8 deletions
This file was deleted.

npm-packages/private-demos/quickstarts/tanstack-start/app/routeTree.gen.ts

Lines changed: 0 additions & 90 deletions
This file was deleted.

npm-packages/private-demos/quickstarts/tanstack-start/app/ssr.tsx

Lines changed: 0 additions & 13 deletions
This file was deleted.

npm-packages/private-demos/quickstarts/tanstack-start/package.json

Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,28 +5,34 @@
55
"description": "",
66
"main": "index.js",
77
"scripts": {
8-
"dev": "vinxi dev",
9-
"build": "vinxi build",
10-
"start": "vinxi start"
8+
"dev": "npx convex dev --once && concurrently -r npm:dev:web npm:dev:convex",
9+
"dev:web": "vite dev",
10+
"dev:ts": "tsc -b -w",
11+
"dev:convex": "npx convex dev",
12+
"build": "vite build && tsc --noEmit",
13+
"start": "node .output/server/index.mjs"
1114
},
1215
"keywords": [],
1316
"author": "",
1417
"license": "ISC",
1518
"dependencies": {
16-
"@convex-dev/react-query": "^0.0.0-alpha.8",
17-
"@tanstack/react-query": "^5.59.20",
18-
"@tanstack/react-router": "^1.82.1",
19-
"@tanstack/react-router-with-query": "^1.82.1",
20-
"@tanstack/start": "^1.82.1",
21-
"convex": "^1.17.0",
19+
"@convex-dev/react-query": "^0.0.0-alpha.11",
20+
"@tanstack/react-query": "^5.89.0",
21+
"@tanstack/react-router-with-query": "^1.130.17",
22+
"@tanstack/react-router": "^1.132.2",
23+
"@tanstack/react-start": "^1.132.2",
24+
"convex": "^1.27.3",
2225
"react": "^18.3.1",
23-
"react-dom": "^18.3.1",
24-
"vinxi": "^0.5.1"
26+
"react-dom": "^18.3.1"
2527
},
2628
"devDependencies": {
27-
"@types/react": "^18.3.12",
29+
"@tailwindcss/vite": "^4.1.13",
2830
"@types/react-dom": "^18.3.1",
29-
"@vitejs/plugin-react": "^4.3.3",
30-
"typescript": "^5.6.3"
31+
"@types/react": "^18.3.12",
32+
"@vitejs/plugin-react": "^5.0.3",
33+
"concurrently": "~9.2.1",
34+
"typescript": "^5.6.3",
35+
"vite-tsconfig-paths": "^5.1.4",
36+
"vite": "^7.1.5"
3137
}
3238
}

0 commit comments

Comments
 (0)