Skip to main content

Troubleshooting & Debugging

In case you are facing issues while following Setup steps or Contributor guidelines command try to follow below steps

info
  • Are you on supported node version (18), check node -v
  • Prefer use yarn instead of npm
  • Are you running the build / lint commands from root folder of GenesisX / workspace or within the package folder, make sure its root folder in either case.
  • Do refer the README.md of packages for exact commands for generating an app as it differs
  • As a last step try to cleanup node_modules yarn.lock package-lock and perform fresh package install
  • In the new workspace run following command to check the nx dependencies versions
    • nx report
    • The version should be 16.6.x for all nx related major dependencies like
    • @nrwl/node, nx, @nrwal/cli

Other Issues​

  • Sometimes the command line or Nx Console commands might not work if starting with yarn like yarn nx generate <package-name>

Solution​

tip
  • Make sure you are on latest version of NodeJS
  • Try to use command line and run the command without yarn nx generate <package-name>

  • Make sure the workspace is created with node 18 (before running npx @genesisx/create-workspace)

  • On windows or other system, while running any Nx command if you get error like

    nx : The term 'nx' is not recognized as the name of a cmdlet

    Try to run the command prefixing with npx like

    npx nx <remaining command>