Skip to content

Update dependencies to fix broken NPM installation and running#255

Merged
kungfuchicken merged 5 commits intomainfrom
update-dependencies
Apr 9, 2026
Merged

Update dependencies to fix broken NPM installation and running#255
kungfuchicken merged 5 commits intomainfrom
update-dependencies

Conversation

@leandrumartin
Copy link
Copy Markdown
Collaborator

Running npm install was not working due to outdated and deprecated dependencies. Specifically, the canvas dependency was causing it to fail (attempting the command with only that dependency removed succeeded). I updated the required version to the minimum required version to get the command to work.

Once npm install ran, npm start was failing to compile the project. The reason given by the errors was that PostCSS 8 was required. Running npm ls postcss revealed that it was a dependency of Docusaurus, so I also upgraded the required Docusaurus version to the minimum that would allow it to run.

Now, both npm install and npm start work.

@kungfuchicken
Copy link
Copy Markdown
Collaborator

When I ran an npm install && npm start the site stopped working locally for me. It builds, but never loads in a browser. This is probably something locally for me. It might even be a browser cache issue. I'll look into it by tomorrow.

One nice thing, though. Somehow it's now respecting my browser preference (opening in Firefox instead of Chrome).

@leandrumartin
Copy link
Copy Markdown
Collaborator Author

It might be local to you. I've tested this on two devices and it works well on both.

leandrumartin and others added 4 commits April 9, 2026 05:28
Updates @docusaurus/core, @docusaurus/preset-classic,
@docusaurus/module-type-aliases, and @docusaurus/types.

No breaking changes in this version range. Build verified
successfully with all existing MDX pages compiling cleanly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Footer: /connect_with/consulting → /connect_with/consult (matches doc id)
- Footer: /connect_with/donations → /connect_with/donate (matches doc id)
- Footer: fix "Consult wiht OSS" typo → "Consult with OSS"
- donations.md: fix relative sponsorship link → /connect_with/sponsor
- get_involved.md: /connect_with/sponsorship → /connect_with/sponsor
- training.md: fix broken ./ link for Slack workspace
- experiential_lerning.md: fix "deveopment" typo in anchor links

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remove four dependencies with no imports anywhere in the codebase:
- docusaurus (v1.14.7) — superseded by @docusaurus/core v3
- @next/mdx — Next.js package, not used by Docusaurus
- canvas — native image dep causing npm install failures
- jpegtran-bin — image optimization binary, unreferenced

Also remove next.config.js, a leftover from a prior Next.js setup
that Docusaurus ignores entirely.

This removes 839 transitive packages and drops reported
vulnerabilities from 113 to 29.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
kungfuchicken
kungfuchicken previously approved these changes Apr 9, 2026
Copy link
Copy Markdown
Collaborator

@kungfuchicken kungfuchicken left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for this update @leandrumartin . It took a bit longer to get back to actually getting it working locally, so I bumped to the latest. In testing Claude noticed some broken links, so we fixed those, too.

Docusaurus 3.9+ requires Node >= 20. Update both workflows to
Node 22 (current LTS, active through Oct 2027).

Also:
- actions/checkout v2 → v4
- actions/setup-node v3 → v4
- Use npm ci for deterministic installs in both workflows
- Remove redundant npm i before npm ci in test-deploy
- Update engines field in package.json to >= 20.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@kungfuchicken kungfuchicken merged commit c4123c3 into main Apr 9, 2026
4 checks passed
@kungfuchicken kungfuchicken deleted the update-dependencies branch April 9, 2026 10:42
github-actions Bot added a commit that referenced this pull request Apr 9, 2026
Update dependencies to fix broken NPM installation and running c4123c3
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants