Dev environment not working?

[azeemh]

what version of react front end and it's dependencies do we need for the dev server to run?

i followed the directions at https://docs.owncast.dev/development and https://owncast.online/help/, even read the project definition at https://docs.owncast.dev/all?v=382ab37bd9b84275803eb99e723bb70e&p=3e663ffe3c494c5d9d479b3e7896f605&pm=s and i know that my efforts align with:

making the software customizable which is part of the definition and use case for the primary user (the diy streamer.)

i installed the branch following directions and try to get npm dev to run but it never does, even though it'll main.go and run perfectly in production mode from clone.

i always get

Error: 1 event(s) were sent to uninitialized service "appState". Make sure .start() is called for this service, or set { deferEvents: true } in the service options.

I was going to add user customizable fields and make PR with functioning code but getting the front end dev environment setup is currently unclear at the moment of writing from the aforementioned documentation.

(upgrading next doesn't help either. I've fully deleted and recloned and tried various versions of node with nvm node version manager, from 23 on my system, to 24, and installed the latest stable release, ver 22.16 as well as that was the highest engine supported by package in npm install

azeem@x9:~/owncast/web$ nvm install 24.2.0
Downloading and installing node v24.2.0...
Downloading https://nodejs.org/dist/v24.2.0/node-v24.2.0-linux-x64.tar.xz...
######################################################################################################################################################################## 100.0%
Computing checksum with sha256sum
Checksums matched!
Now using node v24.2.0 (npm v11.3.0)
azeem@x9:~/owncast/web$ nvm use 24.2
Now using node v24.2.0 (npm v11.3.0)
azeem@x9:~/owncast/web$ npm install
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE   package: 'i18next-parser@9.1.0',
npm warn EBADENGINE   required: { node: '^18.0.0 || ^20.0.0 || ^22.0.0', npm: '>=6', yarn: '>=1' },
npm warn EBADENGINE   current: { node: 'v24.2.0', npm: '11.3.0' }
npm warn EBADENGINE }
npm warn deprecated rimraf@2.6.3: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@2.7.1: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@2.7.1: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm warn deprecated eslint@8.57.1: This version is no longer supported. Please see https://eslint.org/version-support for other options.
npm error code 1
npm error path /home/azeem/owncast/web/node_modules/cypress
npm error command failed
npm error command sh -c node index.js --exec install
npm error node:internal/modules/cjs/loader:1408
npm error   throw err;
npm error   ^
npm error
npm error Error: Cannot find module './promise'
npm error Require stack:
npm error - /home/azeem/owncast/web/node_modules/bluebird/js/release/bluebird.js
npm error - /home/azeem/owncast/web/node_modules/cypress/lib/util.js
npm error - /home/azeem/owncast/web/node_modules/cypress/index.js
npm error     at Module._resolveFilename (node:internal/modules/cjs/loader:1405:15)
npm error     at defaultResolveImpl (node:internal/modules/cjs/loader:1061:19)
npm error     at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1066:22)
npm error     at Module._load (node:internal/modules/cjs/loader:1215:37)
npm error     at TracingChannel.traceSync (node:diagnostics_channel:322:14)
npm error     at wrapModuleLoad (node:internal/modules/cjs/loader:235:24)
npm error     at Module.require (node:internal/modules/cjs/loader:1491:12)
npm error     at require (node:internal/modules/helpers:135:16)
npm error     at Object.<anonymous> (/home/azeem/owncast/web/node_modules/bluebird/js/release/bluebird.js:9:16)
npm error     at Module._compile (node:internal/modules/cjs/loader:1734:14) {
npm error   code: 'MODULE_NOT_FOUND',
npm error   requireStack: [
npm error     '/home/azeem/owncast/web/node_modules/bluebird/js/release/bluebird.js',
npm error     '/home/azeem/owncast/web/node_modules/cypress/lib/util.js',
npm error     '/home/azeem/owncast/web/node_modules/cypress/index.js'
npm error   ]
npm error }
npm error
npm error Node.js v24.2.0
npm error A complete log of this run can be found in: /home/azeem/.npm/_logs/2025-06-23T17_56_25_923Z-debug-0.log
azeem@x9:~/owncast/web$ cd
azeem@x9:~$ npm install -g npm@latest

changed 42 packages in 3s

25 packages are looking for funding
  run `npm fund` for details
azeem@x9:~$ cd owncast/web
azeem@x9:~/owncast/web$ npm install -g npm@latest

changed 15 packages in 3s

25 packages are looking for funding
  run `npm fund` for details
azeem@x9:~/owncast/web$ npm run dev

> owncast-web@0.1.0 dev
> next dev

sh: 1: next: not found
azeem@x9:~/owncast/web$ npm install
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE   package: 'i18next-parser@9.1.0',
npm warn EBADENGINE   required: { node: '^18.0.0 || ^20.0.0 || ^22.0.0', npm: '>=6', yarn: '>=1' },
npm warn EBADENGINE   current: { node: 'v24.2.0', npm: '11.4.2' }
npm warn EBADENGINE }
npm warn deprecated rimraf@2.6.3: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@2.7.1: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@2.7.1: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm warn deprecated eslint@8.57.1: This version is no longer supported. Please see https://eslint.org/version-support for other options.
⠴^C
azeem@x9:~/owncast/web$ ^C
azeem@x9:~/owncast/web$ nvm use 22
Now using node v22.16.0 (npm v10.9.2)
azeem@x9:~/owncast/web$ npm install
npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/azeem/owncast/web/node_modules/antd
npm error dest /home/azeem/owncast/web/node_modules/.antd-sBCJaZOU
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '/home/azeem/owncast/web/node_modules/antd' -> '/home/azeem/owncast/web/node_modules/.antd-sBCJaZOU'
npm error A complete log of this run can be found in: /home/azeem/.npm/_logs/2025-06-23T17_59_59_158Z-debug-0.log
azeem@x9:~/owncast/web$ rm -rf node_modules
azeem@x9:~/owncast/web$ npm install
npm warn deprecated @types/classnames@2.3.4: This is a stub types definition. classnames provides its own type definitions, so you do not need this installed.
npm warn deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm warn deprecated npmlog@5.0.1: This package is no longer supported.
npm warn deprecated rimraf@2.6.3: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@2.7.1: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rimraf@2.7.1: Rimraf versions prior to v4 are no longer supported
npm warn deprecated rollup-plugin-terser@7.0.2: This package has been deprecated and is no longer maintained. Please use @rollup/plugin-terser
npm warn deprecated @humanwhocodes/config-array@0.13.0: Use @eslint/config-array instead
npm warn deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm warn deprecated are-we-there-yet@2.0.0: This package is no longer supported.
npm warn deprecated @humanwhocodes/object-schema@2.0.3: Use @eslint/object-schema instead
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated querystring@0.2.1: The querystring API is considered Legacy. new code should use the URLSearchParams API instead.
npm warn deprecated sourcemap-codec@1.4.8: Please use @jridgewell/sourcemap-codec instead
npm warn deprecated gauge@3.0.2: This package is no longer supported.
npm warn deprecated workbox-cacheable-response@6.6.0: workbox-background-sync@6.6.0
npm warn deprecated workbox-google-analytics@6.6.0: It is not compatible with newer versions of GA starting with v4, as long as you are using GAv3 it should be ok, but the package is not longer being maintained
npm warn deprecated eslint@8.57.1: This version is no longer supported. Please see https://eslint.org/version-support for other options.

added 2677 packages, and audited 2893 packages in 56s

542 packages are looking for funding
  run `npm fund` for details

21 vulnerabilities (1 low, 15 moderate, 4 high, 1 critical)

To address issues that do not require attention, run:
  npm audit fix

To address all issues possible, run:
  npm audit fix --force

Some issues need review, and may require choosing
a different dependency.

Run `npm audit` for details.
azeem@x9:~/owncast/web$ npm run dev

> owncast-web@0.1.0 dev
> next dev

  ▲ Next.js 14.2.21
  - Local:        http://localhost:3000
  - Environments: .env.development

 ✓ Starting...
> [PWA] PWA support is disabled
> [PWA] PWA support is disabled
 ✓ Ready in 2.9s
 ○ Compiling / ...
Browserslist: browsers data (caniuse-lite) is 6 months old. Please run:
  npx update-browserslist-db@latest
  Why you should do it regularly: https://github.com/browserslist/update-db#readme
 ✓ Compiled / in 30.2s (3539 modules)
 GET / 200 in 31969ms
(node:49980) [DEP0060] DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead.
(Use `node --trace-deprecation ...` to show where the warning was created)
Failed to proxy http://localhost:8080/logo Error: connect ECONNREFUSED 127.0.0.1:8080
    at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1636:16) {
  errno: -111,
  code: 'ECONNREFUSED',
  syscall: 'connect',
  address: '127.0.0.1',
  port: 8080
}

i tried audit fixes and everything but it's kind of impossible to make a pr if you can't get the dev environment to start.

I hope to get this going because the improvements we seek to code would really make the platform much better and easier to use and customize.

[gabek]

Do you have the server running as well?

[gabek]

I was going to add user customizable fields and make PR with functioning code but getting the front end dev environment setup is currently unclear at the moment of writing from the aforementioned documentation.

Please file a discussion ticket before a PR with the details of what you intend to build and how. Otherwise, you might put in a ton of work, but it might not align with the project, its goals, or the approach. Or there might be things in the roadmap that you aren't aware of that might make sense to discuss with this. It's important to talk new functionality through first.