Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

/example/README.md doesn't mention creating an app first

Open
#162 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
52/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
firebase, javascript, react
Domain
documentation

Research direction

Start with /example/README.md and reproduce the setup through npm run build, checking the generated firebase-config.json and the App.jsx:10 error. Update the README to cover creating a web app with firebase apps:create and checking existing apps with firebase apps:list; done means a new reader can complete the example without the reported runtime error.

Written by the indexing model from the issue text.

Description

I followed example README.md exactly, and result was the example didn't work, with a runtime JS error:

Uncaught TypeError: Cannot read properties of undefined (reading 'sdkConfig')
    at Object.<anonymous> (App.jsx:10:58)

Cause of the above is npm run build produced firebase-config.json that contained an error (with misleading message, firebase/firebase-tools/issues/4007) because I hadn't created a "web" app yet in the Firebase project.

The readme, since it has readers create a new Firebase project, should include a firebase apps:create invocation, to ensure there's a web app available. Could also mention using firebase apps:list, in case the Firebase project is not new, already has 2 apps, which I presume causes the same error(?) - I can imagine people trying to use most of these steps with an existing project.

Dominant language
JavaScript
Stars
1.3k
Forks
246
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from firebase/firebaseui-web-react

All issues in firebase/firebaseui-web-react

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.