Tansatack start with convex error

[hollow flame]

i followed the guide , when i run , npm run dev , i get :
npm run dev

[email protected] dev
npx convex dev --once; npm-run-all --parallel dev:convex dev:start

error: unknown option '--once;'

[solemn cobalt]

Thanks for posting in #1088161997662724167.
Reminder: If you have a Convex Pro account, use the Convex Dashboard to file support tickets.

    - Provide context: What are you trying to achieve, what is the end-user interaction, what are you seeing? (full error message, command output, etc.)
    - Use [search.convex.dev](https://search.convex.dev) to search Docs, Stack, and Discord all at once.
    - Additionally, you can post your questions in the Convex Community's #1228095053885476985 channel to receive a response from AI.
    - Avoid tagging staff unless specifically instructed.

    Thank you!

[white fern]

It looks like you might not be on the latest version of the NPM convex package. What version are you using?

[neat crown]

Are you on windows by chance?

[hollow flame]

yes

[neat crown]

Joining in a separate thread, @eager urchin said:

Guys, I'm having an initialization error:
convex 1.23.0
npm run dev
[email protected] predev
convex dev --until-success && convex dev --once --run-sh 'node setup.mjs --once' && convex dashboard
.
.
.
error: unknown option '--once''
(Did you mean --once?)
(source: https://discord.com/channels/1019350475847499849/1359878397387608086)

So you're both on windows, I'm on mac and unable to reproduce. I'll see if someone else on windows is able to repro.

[hollow flame]

thank you

[neat crown]

Can you share your package.json

[hollow flame]

one moment , cause i delete it that project and used tanstack and added convex after

{
"name": "test",
"type": "module",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"dev": "npx convex dev --once; npm-run-all --parallel dev:convex dev:start",
"dev:convex": "convex dev",
"dev:start": "vinxi dev",
"seed": "npx convex dev --once; npx convex import --table tasks sampleData.jsonl",
"build": "vinxi build",
"start": "vinxi start"
},
"keywords": [],
"author": "",
"dependencies": {
"@convex-dev/react-query": "^0.0.0-alpha.8",
"@tanstack/react-query": "^5.59.20",
"@tanstack/react-router": "^1.82.1",
"@tanstack/react-router-with-query": "^1.82.1",
"@tanstack/start": "^1.82.1",
"convex": "^1.23.0",
"react": "^18.3.1",
"react-dom": "^18.3.1",
"vinxi": "^0.4.3"
},
"devDependencies": {
"@types/react": "^18.3.12",
"@types/react-dom": "^18.3.1",
"@vitejs/plugin-react": "^4.3.3",
"npm-run-all": "^4.1.5",
"typescript": "^5.6.3"
}
}

sorry coudn't send he file, it fails for some reason

[neat crown]

hmm I bet it was the semi-colon

thanks, this is perfect. Can you see if replacing the semi-colon with && lets it run for you?

[hollow flame]

the working one from tanstack start docs is like this :

{
"name": "tanstack-start-example-convex-trellaux",
"private": true,
"sideEffects": false,
"type": "module",
"scripts": {
"dev": "npx convex dev --once && concurrently -r npm:dev:web npm:dev:db",
"dev:web": "vinxi dev",
"dev:db": "convex dev --run board:seed",
"build": "vinxi build",
"start": "vinxi start"
},
"dependencies": {
"@convex-dev/react-query": "0.0.0-alpha.8",
"@tanstack/react-query": "^5.66.0",
"@tanstack/react-query-devtools": "^5.66.0",
"@tanstack/react-router": "^1.115.2",
"@tanstack/react-router-with-query": "^1.115.2",
"@tanstack/react-router-devtools": "^1.115.2",
"@tanstack/react-start": "^1.115.2",
"concurrently": "^8.2.2",
"convex": "^1.19.0",
"ky": "^1.7.4",
"msw": "^2.7.0",
"react": "^19.0.0",
"react-dom": "^19.0.0",
"react-hot-toast": "^2.5.1",
"redaxios": "^0.5.1",
"tailwind-merge": "^2.6.0",
"tiny-invariant": "^1.3.3",
"vinxi": "0.5.3",
"zod": "^3.24.2"
},
"devDependencies": {
"@types/react": "^19.0.8",
"@types/react-dom": "^19.0.3",
"postcss": "^8.5.1",
"autoprefixer": "^10.4.20",
"tailwindcss": "^3.4.17",
"typescript": "^5.7.2",
"vite-tsconfig-paths": "^5.1.4"
}
}

[hollow flame]

ok i will

in tanstack start they use concurrently

[neat crown]

but I notice they use && also after the --once flag

[hollow flame]

yes

[neat crown]

are you on node 23?

sorry just trying to get all the info I can to understand the root cause here. Feels like something changed recently for windows users, not sure what

[hollow flame]

so the command worked now

but the app hass errors

white screen

[neat crown]

the hydration mismatch I've seen before, but the screen is blank?

[hollow flame]

20.10.0

[hollow flame]

yes

[neat crown]

okay, and the convex trellaux example you used from the tanstack docs works okay right? or is it blank as well

[hollow flame]

it works great, kanban example

[neat crown]

okay, so the convex template needs to be fixed, will see if I can repro that

thanks for the info here

[hollow flame]

thank you for your time

[neat crown]

in the convex template, did you run npm run seed before npm run dev?

If you've run the seed script, the app will look like this (just three text items in the top left)

[hollow flame]

yes i did

there is no text

blank error screen

i just realized that seed has the same error &&

[neat crown]

yeah that's because of the semi-colon after --once, try replacing that with && and rerunning the seed command

[hollow flame]

i did , teh seed worked

[neat crown]

okay good, does dev have content now

err i mean does npm run dev work for you and show content on screen

[neat crown]

okay awesome - still errors?

[hollow flame]

yes

[neat crown]

I've seen those at times in dev with next ssr, might be a similar situation

[hollow flame]

as for the template itself, the tanstack start one is better , it show more of the features and i learn from it a lot , would love a similar template from the convex side but maybe with a crud simple app

i just checked the tanstack template log and there is no errors , but that's a separate issue

thanks so much for your help, we can close this issue now