cant run docs locally on windows

[Unknown47Dream]

Node: v24.1.0
OS: Windows

npm start crashes on "preparing local preview" with this error:

Error: ENOENT: no such file or directory, open 'C:\Users\xxx.mintlify\mint\apps\client.next\required-server-files.json'
at Object.readFileSync (node:fs:433:20)
at setupNext (file:///D:/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/setupNext.js:29:32)
at run (file:///D:/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/run.js:51:34)
at dev (file:///D:/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/index.js:58:11) {
errno: -4058,
code: 'ENOENT',
syscall: 'open',
path: 'C:\Users\xxx\.mintlify\mint\apps\client\.next\required-server-files.json'
}

[novusnota]

Hmm, sometimes local previews misbehave on other systems as well. Have you tried re-running it? Also, we've just updated the Mintlify version in package-lock.json recently, so try npm ci to update and then please, retry starting a local preview.

[Unknown47Dream]

i already tried so many times. first got the latest changes. then removing the node_models with clean install.
also removed .mintlify couple of times. i even tried every node versions from 20 to 26 but still no luck.

npm warn Unknown project config "min-release-age". This will stop working in the next major version of npm.

start
npx mint dev

npm warn Unknown env config "min-release-age". This will stop working in the next major version of npm.
npm warn Unknown project config "min-release-age". This will stop working in the next major version of npm.
usage: mintlify dev [options]

Options:
-t, --telemetry Enable or disable anonymous usage telemetry [boolean]
--open open a local preview in the browser
[boolean] [default: true]
--groups Mock user groups for local development and testing
[array]
--disable-openapi Disable OpenAPI file generation
[boolean] [default: false]
-h, --help Show help [boolean]
-v, --version Show version number [boolean]

Examples:
mintlify dev run with default settings (opens in browser)
mintlify dev --no-open run without opening in browser

Error: ENOENT: no such file or directory, open 'C:\Users\xxx.mintlify\mint\apps\client.next\required-server-files.json'
at Object.readFileSync (node:fs:433:20)
at setupNext (file:///D:/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/setupNext.js:29:32)
at run (file:///D:/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/run.js:51:34)
at dev (file:///D:/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/index.js:58:11) {
errno: -4058,
code: 'ENOENT',
syscall: 'open',
path: 'C:\Users\xxx\.mintlify\mint\apps\client\.next\required-server-files.json'
}

[Unknown47Dream]

wsl mode on windows outputs different error text!

Error: Client not built. Run: cd /apps/client && STANDALONE_BUILD=true NEXT_PUBLIC_ENV=cli yarn build
at setupNext (file:///mnt/d/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/setupNext.js:37:19)
at run (file:///mnt/d/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/run.js:51:34)
at dev (file:///mnt/d/Workspace/ton/docs/node_modules/@mintlify/previewing/dist/local-preview/index.js:58:11)

[novusnota]

Ok, please report this to Mintlify: https://github.com/orgs/mintlify/discussions

I'll try to ping them on this.

[Unknown47Dream]

im too lazy to do that but thanks for the conversation. seems like i should stick with the website.

[novusnota]

@Unknown47Dream hey, did it get resolved, or did you switch to another documentation version currently deployed from https://github.com/the-ton-tech/ton-docs-private?

UPD: Nevermind, the latter is an experiment.

[Unknown47Dream]

Somehow after git pull and clean install it worked! 😌
didnt know about this doc you mentioned, whats new about it?