[bug]: insufficient development instructions

[stankovski]

Is there an existing issue for this?

• There is no exsiting issue for this bug

Describe the bug

When I follow instructions described under https://github.com/quran/quran.com-frontend-next?tab=readme-ov-file#running-the-app-locally I'm getting 404 trying to navigate to any surah.

Start page Reading page

Relevant log output

GET /_next/data/development/en/105.json?startingVerse=1&chapterId=105 404 in 45ms
next-translate - compiled page: /_error - locale: en - namespaces: common, error, radio, quick-links, onboarding, login - used loader: getInitialProps
 GET /_next/static/chunks/pages/404.js 404 in 75ms
It is highly recommended to set `predictableActionArguments` to `true` when using `createMachine`. https://xstate.js.org/docs/guides/actions.html
redux-persist failed to create sync storage. falling back to noop storage.
next-translate - compiled page: /[chapterId] - locale: en - namespaces: common, error, radio, quick-links, onboarding, login, quran-reader, reading-goal, notes, chapter, surah-info - used loader: getStaticProps
next-translate - compiled page: /_error - locale: en - namespaces: common, error, radio, quick-links, onboarding, login - used loader: getInitialProps
 GET /105?startingVerse=1 404 in 122ms
It is highly recommended to set `predictableActionArguments` to `true` when using `createMachine`. https://xstate.js.org/docs/guides/actions.html
redux-persist failed to create sync storage. falling back to noop storage.

Steps to reproduce

1. Clone repo
2. Run yarn
3. Run yarn dev
4. Open localhost:3000
5. Navigate to any surah

Environment (please complete the following information) and Add any other context about this bug

MacOS 26.1
Edge 142.0.3595.94

Environment

Staging(next.quran.com)

[emircanerkul]

Am i doing something wrong?

Receiving objects: 19% (12931/64869), 1.27 GiB | 7.38 MiB/s

Repository is too big.. isn't that weird?

[stankovski]

Yeah it took some time, but eventually it cloned.

[ishtiaqurrahman]

is dev data unavailable?

cloned
tried accessing chapter 1

Operating System: Ubuntu 24.04.3 LTS
Chrome Version 143.0.7499.146 (Official Build) (64-bit)

next-translate - compiled page: /[chapterId] - locale: en - namespaces: common, error, radio, quick-links, onboarding, login, quran-reader, reading-goal, notes, chapter, surah-info - used loader: getServerSideProps GET /_next/data/development/en/1.json?chapterId=1 404 in 163ms next-translate - compiled page: /_error - locale: en - namespaces: common, error, radio, quick-links, onboarding, login - used loader: getInitialProps GET /_next/static/chunks/pages/404.js 404 in 78ms