Skip to content

Improve setup guides and Node.js version management across all platforms#861

Merged
tjementum merged 5 commits intomainfrom
pp-1074-rewrite-linux-setup-guide
Mar 19, 2026
Merged

Improve setup guides and Node.js version management across all platforms#861
tjementum merged 5 commits intomainfrom
pp-1074-rewrite-linux-setup-guide

Conversation

@tjementum
Copy link
Member

@tjementum tjementum commented Mar 19, 2026

Summary & Motivation

Testing on a fresh Ubuntu 24.04 ARM installation revealed that the existing Linux/WSL2 guide was outdated and incomplete. The recent migration from SQL Server to PostgreSQL removed the x86 dependency, making it possible to run the full solution on ARM-based Linux virtual machines — enabling Claude Code in isolated environments.

  • Rewrite the Linux setup guide with tested step-by-step instructions for Ubuntu/Debian, including Docker, HTTPS certificate trust, and Snap Chromium support
  • Lower the Docker minimum version to 27.0.0 for Ubuntu 24.04 compatibility
  • Ignore HTTPS errors in Playwright on both Windows and Linux, where bundled browsers do not trust the ASP.NET dev certificate
  • Simplify the Node.js version check to use node --version directly instead of scanning version manager directories, and accept any matching major version >= .node-version
  • Auto-install the correct Node.js version via fnm when present but the required version is missing
  • Recommend fnm as a Node.js version manager across all platform guides, with direct Node.js installation as an alternative
  • Update .node-version to 24.14.0
  • Add clone command and repository navigation instructions to the getting started steps
  • Restructure Mac and Windows guides with numbered steps and separate Node.js installation step

Checklist

  • I have added tests, or done manual regression tests
  • I have updated the documentation, if necessary

@tjementum tjementum self-assigned this Mar 19, 2026
@tjementum tjementum requested a review from a team as a code owner March 19, 2026 20:45
@tjementum tjementum added the Enhancement New feature or request label Mar 19, 2026
@linear
Copy link

linear bot commented Mar 19, 2026

@tjementum tjementum force-pushed the pp-1074-rewrite-linux-setup-guide branch from feb4a01 to cb869af Compare March 19, 2026 20:47
@tjementum tjementum moved this to 🏗 In Progress in Kanban board Mar 19, 2026
@tjementum tjementum force-pushed the pp-1074-rewrite-linux-setup-guide branch from cb869af to 2ff8040 Compare March 19, 2026 21:54
@tjementum tjementum force-pushed the pp-1074-rewrite-linux-setup-guide branch from 2ff8040 to e9c0bab Compare March 19, 2026 22:00
@tjementum tjementum changed the title Rewrite Linux setup guide and fix compatibility issues found during testing Improve setup guides and Node.js version management across all platforms Mar 19, 2026
@tjementum tjementum force-pushed the pp-1074-rewrite-linux-setup-guide branch from e9c0bab to 9f7e451 Compare March 19, 2026 22:34
@sonarqubecloud
Copy link

@tjementum tjementum merged commit 69c5540 into main Mar 19, 2026
35 checks passed
@tjementum tjementum deleted the pp-1074-rewrite-linux-setup-guide branch March 19, 2026 23:53
@github-project-automation github-project-automation bot moved this from 🏗 In Progress to ✅ Done in Kanban board Mar 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Enhancement New feature or request

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

1 participant