Hello!
I’ve just right now fetched the upstream, pulled the repo and tried to npm i:
npm i --force worked though.
EDIT: However:
Any thoughts?
Thank you!
you should use yarn and not npm, there is a yarn lock file as well that will help your dependencies resolution
1 Like
OMG! I totally forgot that it’s yarn based. Sorry for this one! It seems I am switching projects and environments too often 
EDIT: it works when using yarn, obviously 
2 Likes
Hey @RaananW! I’m back!
Back to my previous post: I could yarn start and yarn dev previously, I’ve clicked some pages and it worked but my changes weren’t reflected in the resulting pages later and had some errors in the logs so I did a new git clone of the repo in an another directory, yarn install, yarn build:local modified a file then yarn dev and the changes are not visible. I just couldn’t get it working. As you might know I already created a bunch of PRs for the documentation so I am familiar with the process but this is now just not working for me 
I just can’t get the new content get displayed… Would you please have a look at my log? Only some warning, no errors
I must miss something trivial… There is a screenshot at the top showing that the file is saved in VS Code and in two different browser I always get the original content.
Thanks a lot!
PS C:\code\babylonjs> git clone GitHub - BabylonJS/Documentation: Babylon.js's documentation website Documentation2
Cloning into ‘Documentation2’…
remote: Enumerating objects: 13700, done.
remote: Counting objects: 100% (2434/2434), done.
remote: Compressing objects: 100% (1001/1001), done.
remote: Total 13700 (delta 1514), reused 2186 (delta 1389), pack-reused 11266Receiving objects: 100% (13700/13700), 345.43 MiB | 11.18 MiB
Receiving objects: 100% (13700/13700), 348.24 MiB | 12.75 MiB/s, done.
Resolving deltas: 100% (7992/7992), done.
Updating files: 100% (3439/3439), done.
PS C:\code\babylonjs> yarn install
yarn install v1.22.10
info No lockfile found.
[1/4] Resolving packages…
[2/4] Fetching packages…
[3/4] Linking dependencies…
[4/4] Building fresh packages…
success Saved lockfile.
Done in 0.06s.
PS C:\code\babylonjs> cd .\Documentation2
PS C:\code\babylonjs\Documentation2> yarn install
yarn install v1.22.10
[1/4] Resolving packages…
[2/4] Fetching packages…
info @next/swc-darwin-arm64@11.1.2: The platform “win32” is incompatible with this module.
info “@next/swc-darwin-arm64@11.1.2” is an optional dependency and failed compatibility check. Excluding it from installation.
info @next/swc-darwin-arm64@11.1.2: The CPU architecture “x64” is incompatible with this module.
info @next/swc-darwin-x64@11.1.2: The platform “win32” is incompatible with this module.
info “@next/swc-darwin-x64@11.1.2” is an optional dependency and failed compatibility check. Excluding it from installation.
info @next/swc-linux-x64-gnu@11.1.2: The platform “win32” is incompatible with this module.
info “@next/swc-linux-x64-gnu@11.1.2” is an optional dependency and failed compatibility check. Excluding it from installation.
info fsevents@2.3.2: The platform “win32” is incompatible with this module.
info “fsevents@2.3.2” is an optional dependency and failed compatibility check. Excluding it from installation.
[3/4] Linking dependencies…
warning " > @next/mdx@11.1.2" has unmet peer dependency “@mdx-js/react@*”.
warning “next > styled-jsx > @babel/plugin-syntax-jsx@7.14.5” has unmet peer dependency “@babel/core@^7.0.0-0”.
warning " > react-super-responsive-table@5.2.0" has unmet peer dependency “prop-types@>= 15”.
warning " > typedoc@0.19.2" has incorrect peer dependency “typescript@3.9.x || 4.0.x”.
[4/4] Building fresh packages…
Done in 18.97s.
PS C:\code\babylonjs\Documentation2> yarn build:local
yarn run v1.22.10
$ next build
info - Using webpack 5. Reason: Enabled by default Webpack 5 Adoption | Next.js
warn - You have enabled experimental feature(s).
warn - Experimental features are not covered by semver, and may cause unexpected or broken application behavior. Use them at your own risk.
info - Checking validity of types
warn - No ESLint configuration detected. Run next lint to begin setup
info - Creating an optimized production build
info - Compiled successfully
info - Collecting page data …main getStaticPages
info - Collecting page data .API - get static paths
making sure directory is empty C:\code\babylonjs\Documentation2.temp\docdirectory
generating API docs, patience is required
info - Collecting page data …
Using TypeScript 4.4.2 from C:\code\babylonjs\Documentation2\node_modules\typescript\lib
Warning: You are running in an unsupported TypeScript version! TypeDoc supports 3.9.x || 4.0.x
Deprecated as of 10.7.0. Please use highlight(code, options) instead.
info - Collecting page data …
Documentation generated at C:\code\babylonjs\Documentation2.temp\docdirectory\files
API done
info - Collecting page data
[ ==] info - Generating static pages (578/1758)[BABEL] Note: The code generator has deoptimised the styling of undefined as it exceeds the max of 500KB.
[ ==] info - Generating static pages (1756/1758)error pg #SGVUBC#10
[ =] info - Generating static pages (1756/1758)error pg #HE33TR#0
[ =] info - Generating static pages (1757/1758)error pg #HE33TR#2
info - Generating static pages (1758/1758)
info - Finalizing page optimization
Page Size First Load JS
┌ ● / (3222 ms) 1.52 kB 198 kB
├ /_app 0 B 87.4 kB
├ ● /[…id] (315137 ms) 207 B 197 kB
├ ├ /divingDeeper/webXR/WebXRSelectedFeatures (125892 ms)
├ ├ /divingDeeper/mesh/path3D (64763 ms)
├ ├ /start/chap1/first_app (3306 ms)
├ ├ /start/chap1/first_scene (3213 ms)
├ ├ /start/chap1/first_import (3212 ms)
├ ├ /start/chap1/first_viewer (3157 ms)
├ ├ /start/chap2/ground (3157 ms)
├ └ [+561 more paths]
├ ○ /404 (1733 ms) 1.47 kB 147 kB
├ ● /examples (2673 ms) 2.59 kB 202 kB
├ ● /playground (2590 ms) 10.3 kB 207 kB
├ ● /search (2638 ms) 2.71 kB 202 kB
├ ● /typedoc (5398 ms) 1.38 kB 497 kB
└ ● /typedoc/[…id] (203366 ms) 1.55 kB 497 kB
├ /typedoc/classes/babylon.abstractmesh (3101 ms)
├ /typedoc/classes/babylon.anaglypharcrotatecamera (2189 ms)
├ /typedoc/classes/babylon.ammojsplugin (2076 ms)
├ /typedoc/classes/babylon.addblock (1971 ms)
├ /typedoc/classes/babylon.actionmanager (1957 ms)
├ /typedoc/classes/babylon.basisfileinfo (1943 ms)
├ /typedoc/classes/babylon.abstractscene (1873 ms)
└ [+1176 more paths]
- First Load JS shared by all 87.4 kB
├ chunks/framework.2f6124.js 42.4 kB
├ chunks/main.05ba1f.js 23.4 kB
├ chunks/pages/_app.9c5e2d.js 20.8 kB
├ chunks/webpack.90a60b.js 838 B
└ css/0e8f25fdef66fee9733d.css 10.4 kB
λ (Server) server-side renders at runtime (uses getInitialProps or getServerSideProps)
○ (Static) automatically rendered as static HTML (uses no initial props)
● (SSG) automatically generated as static HTML + JSON (uses getStaticProps)
(ISR) incremental static regeneration (uses revalidate in getStaticProps)
Done in 208.94s.
yarn run v1.22.10
$ next start
ready - started server on 0.0.0.0:3000, url: http://localhost:3000
warn - You have enabled experimental feature(s).
warn - Experimental features are not covered by semver, and may cause unexpected or broken application behavior. Use them at your own risk.
PS C:\code\babylonjs\Documentation2> yarn watch
yarn run v1.22.10
$ next-remote-watch content
info - Using webpack 5. Reason: Enabled by default Webpack 5 Adoption | Next.js
warn - You have enabled experimental feature(s).
warn - Experimental features are not covered by semver, and may cause unexpected or broken application behavior. Use them at your own risk.
info - automatically enabled Fast Refresh for 1 custom loader
event - compiled successfully
Ready on http://localhost:3000
event - build page: /404
wait - compiling…
event - build page: /404
event - build page: /404
event - compiled successfully
event - build page: /[…id]
wait - compiling…
event - compiled successfully
main getStaticPages
main getStaticPages
PS C:\code\babylonjs\Documentation2> yarn watch
yarn run v1.22.10
$ next-remote-watch content
info - Using webpack 5. Reason: Enabled by default Webpack 5 Adoption | Next.js
warn - You have enabled experimental feature(s).
warn - Experimental features are not covered by semver, and may cause unexpected or broken application behavior. Use them at your own risk.
info - automatically enabled Fast Refresh for 1 custom loader
event - compiled successfully
Ready on http://localhost:3000
event - build page: /404
wait - compiling…
event - compiled successfully
event - build page: /[…id]
wait - compiling…
event - compiled successfully
main getStaticPages
main getStaticPages
wait - compiling…
event - compiled successfully
main getStaticPages
Not sure what’s up with your setup, but it works well on my side.
I don’t use watch, i use dev. Use dev, and refresh the page after making a change, it should work as expected
I tried to clone the repo on another PC and it works as expected. I must have some evil global package installed on my PC which doesn’t allow to run the Documentation app correctly.
2 Likes