Help with First Time Frontity Quick Start Not Working


I’m new to Frontity and haven’t been able to get past the Quick Start guide, so I’m hoping the community can help me troubleshoot what’s going on.

In a nut shell, I’m able to create a new Frontity project, but when I go to the “Start Development” step and run npx frontity dev my console shows a ton of warnings and then errors out with the following message:

Error: Invalid hook call. Hooks can only be called inside of the body of a fun
ction component. This could happen for one of the following reasons:

  1. You might have mismatching versions of React and the renderer (such as Reac
    t DOM)
  2. You might be breaking the Rules of Hooks
  3. You might have more than one copy of React in the same app
    See for tips about how to debug and fix
    this problem.
    at resolveDispatcher (webpack-internal:///./node_modules/react/cjs/react.d
    at useRef (webpack-internal:///./node_modules/react/cjs/react.development.
    at eval (webpack-internal:///./node_modules/@frontity/connect/src/connect.
    at processChild (webpack-internal:///./node_modules/react-dom/cjs/react-do
    at resolve (webpack-internal:///./node_modules/react-dom/cjs/react-dom-ser
    at ReactDOMServerRenderer.render (webpack-internal:///./node_modules/react
    at (webpack-internal:///./node_modules/react-d
    at renderToString (webpack-internal:///./node_modules/react-dom/cjs/react-
    at eval (webpack-internal:///./node_modules/@frontity/core/src/server/inde
    at runMicrotasks ()

From there, I visited the FB support page but from what I can see all 3 issues mentioned look okay, so I’m not sure if I’m missing something or what…

Here is the output from npx frontity info:


  • OS: Windows 8.1 6.3.9600
  • CPU: (4) x64 Intel® Core™ i5-3337U CPU @ 1.80GHz
  • Memory: 1.90 GB / 7.87 GB


  • Node: 14.15.0 - C:\Program Files\nodejs\node.EXE
  • npm: 6.14.8 - C:\Program Files\nodejs\npm.CMD


  • Chrome: Not Found
  • Internet Explorer: 11.0.9600.19036


  • @frontity/core: ^1.9.1 => 1.9.1
  • @frontity/html2react: ^1.5.0 => 1.5.0
  • @frontity/mars-theme: ./packages/mars-theme => 1.4.4
  • @frontity/tiny-router: ^1.2.4 => 1.2.4
  • @frontity/wp-source: ^1.10.0 => 1.10.0
  • frontity: ^1.13.0 => 1.13.0


  • frontity: Not Found
  • npx: Not Found

Where should I poke around or what can I troubleshoot next?

Hi @floydhartford

Welcome to the Frontity community.

What have you done so far? e.g. which theme did you select? Have you changed the URL to point the your WordPress site? Have you made any other code changes?

A fresh Frontity install using npx frontity create should just work and not throw any errors.

Also where are you seeing the errors, in the browser console or in the terminal?

Hi @mburridge,

Like I said in the OP - all I have done is run the commands from the Quick Start

It’s relatively short and I didn’t anticipate errors at this point either.

From terminal:

npx frontity create my-app

I picked the Mars theme, as suggested.

cd my-app

and then

npx frontity dev

That’s as far as things went. There is no WordPress or any coding being done yet.

Frontity launches my browser at localhost:3000. Terminal gives me the errors I pasted. The browser says “Internal Server Error”

Hi @floydhartford

I don’t have a Windows machine to try to reproduce this. Anyone else with Windows getting this error?

It’s strange that a fresh install is failing. You shouldn’t need to at this stage but try these steps to see if it resolves the issue.

Ok, tried that – same results.

  1. Deleted /my-app/node_modules
  2. Deleted /my-app/package-lock.json
  3. Ran npm install (seemed to work fine)
  4. Ran npm update (did nothing)
  5. Ran npx frontity dev

Again, it opened my browser (Chrome) to localhost:3000 with a message of “Internal Server Error”

I don’t have any other local servers or anything running and there are no other files inside of my project folder except what gets installed from npx frontity create my-app.

Hi @floydhartford,
I’m new to Frontity also but am on a Mac. I have some questions after reading your issues.

In your initial post you mentioned you were on Windows and from your npx frontity info you were using IE. In your latest post you mention using the Chrome browser. Just to clarify, which browser are you using? Secondly, regardless of browser, Internal Server Error appears on the web page itself. Can you open Developer Tools for the page running at localhost:3000 and then look in the Console tab, this tab can possibly give us a more specific error to help debug.

@sattley yes, it opens in Chrome - I’m definitely using Chrome. There’s no custom configuration or anything like that, so I assume IE is a Windows default setting from Frontity, but I have a Chrome browser open and it’s using that.

The console message isn’t much help.

Failed to load resource: the server responded with a status of 500 (Internal Server Error)

Hi @floydhartford,
Yep not much help. I hate when I’m trying a new Framework and it doesn’t work so I’m interested to help as much as possible, though I’m really just troubleshooting here.

I’ve spent the last few hours doing the following:

  • I built the frontity app from scratch using the Quickstart guide and it ran with no issues at localhost:3000. (I changed zero code)

  • I then built the frontity app again using the latest version of node v15.5.1 and I got this error:

  • I then switched to the exact version of Node and npm that you were using, Node v14.15.0 and npm v6.14.8. Rebuilt the app from scratch again and it worked fine.

Some thoughts on this, have you tried switching to an earlier version of Node and npm and then trying to build the app? Until today all of my development on Frontity was done using Node v10.9.0 and npm v6.7.0

Again I use a MacBook and use something called Node Version Manager to easily switch between versions of Node, maybe try that on your PC . . .

Hopefully something here is helpful or makes someone else think of something as the issue. Good luck!


I appreciate you trying to help. For real.

I’ve been doing a similar thing today except going forward instead of backwards with both Node and npm.

  • First, I updated Node to v15 - (no change w/ my errors)
  • Next, I updated npm to the latest minor version (7.4.0)
  • Now, I’ve deleted the “my-app” folder and ran npx frontity create my-app

Still getting the same error and results.

Is it normal to get a bazillion terminal warnings about “There are multiple modules with names that only differe in casing.”? Before it errors out with the message about React hooks, I get a bunch of those and then it says “compiled with warnings”

And, to answer your question - No, I haven’t tried reverting to earlier versions of Node and npm.

If that’s the solution… I’ll pass on frontity for now. I don’t need to use it for anything - just thought it seemed like a cool way to WordPress with React and I was looking forward to trying it out. And, in the back of my mind, there’s always the chance it’s because I’m on Windows 8.1 (=

Hey @floydhartford,
Sorry to hear that. So a few last things you may want to look into, in no particular order:

  • I came across another thread on this site where people where having ‘npx’ issues on
    Windows due to the user folder containing a space. See here -> Error running npx

  • Furthermore because of you mentioning the error about having mismatched versions of React . . . There is this link from React’s site -> I guess it’s possible to have conflicting versions of React. You can run this check on the cmd line from within your project:

npm ls react

The output should only show one React in the dependency tree.

  • Lastly, I did some Googling around and it seems that Windows 8.1 is pretty old. I saw a few things here and there about the support for newer versions of Node being spotty. I’m not a Windows person but from reading around sounds like very few people are running Windows 8.1 these days. Maybe time to update the OS :wink:

Anyway I’ll be working starting tomorrow so my responses may become spottier, either way keep us updated!


Hi @floydhartford

Sorry to hear that you’re still having problems. Are you using GitBash as your command prompt, instead of the Windows console? I found this thread which indicates that this could cause problems similar to the one you’re experiencing.

Otherwise it might be that Windows is at least part of the problem. Does the name of your home directory have a space and/or capitalisation in it? Try creating the project outside of your home directory, e.g. create a dev folder in the root of C: and install the Frontity project in there.

I hope that the above helps and that you get to resolve the issue and persevere with Frontity.

Thanks also to @sattley for helping out so assiduously. :ok_hand:

1 Like

There are no spaces in my path (c:\wamp\www\frontity)
It’s in the wamp folder, but I’m not actively running wamp, so no conflict there.

npm ls react returns:

'-- (empty)

I’m using Node.js command prompt (not Git bash)

There are no spaces or capital letters in my home directory. c:\wamp\www\frontity

I want to say it’s Windos 8.1 too, but then I can’t think of any other package I’ve ever had this sort of problem with, so… I mean, maybe?


Try creating the Frontity project in a separate folder from wamp. I’m guessing you have your local WordPress installation in the wamp folder and wamp will be serving content from that folder, albeit on a separate port from npx frontity dev, but it might be causing some kind of issue for some reason. I don’t know, worth a try! :man_shrugging:t2:

The only reason Windows might be affecting this is because of the file/folder naming convention, but this doesn’t seem to be an issue in your case.

TBH I’m running out of options here. I’m going to refer this to a member of the dev team to see if they can suggest anything. @luisherranz do you have any ideas on this?

I’ve just tried a fresh run at c:\workspace\frontity

Same errors.

I don’t know what may be going on in your computer, we’ve never seen this.

Can you start the server, clean the console, try to do a new request (open localhost:3000 or refresh) and send a capture or a log of what the Frontity server outputs in the console?

Hi @luisherranz - welcome to the thread.

GET http://localhost:3000/ 500 (Internal Server Error)

Before refreshing the page, the original console error message is:

Failed to load resource: the server responded with a status of 500 (Internal Server Error)

Sorry, I meant the terminal, not the console.

@luisherranz if you scroll up a couple comments, there’s a screenshot of my terminal (cmd)