Skip to content

Conversation

@tafaust
Copy link
Contributor

@tafaust tafaust commented Oct 3, 2025

  • Add optional asdf support for tool management (Go, Node.js, pnpm)
  • Create .tool-versions to specify tool versions (Go 1.24.1, Node.js 22.0.0, pnpm 9.0.0)
  • Add make setup target for automated development environment setup
  • Create wrapper scripts (scripts/go.sh, scripts/pnpm.sh) that auto-detect asdf availability
  • Update Makefile and package.json to use wrapper scripts for consistent tool usage
  • Update development documentation with asdf setup instructions

This is purely optional. asdf is a multiple runtime version manager that automatically manages tool versions. If asdf is not available, the project falls back to system-installed binaries. See https://asdf-vm.com/

Usage:

  • With asdf: make setup (one-time setup), then use commands normally
  • Without asdf: Install tools manually, then use commands normally

@tafaust
Copy link
Contributor Author

tafaust commented Oct 3, 2025

I can also add pnpm if requested.

@tafaust tafaust mentioned this pull request Oct 4, 2025
@tafaust tafaust force-pushed the feature/asdf-golang branch from 7b1f37c to cb18e86 Compare October 7, 2025 06:03
* Modify Makefile to use asdf for running Go commands
* Add .asdfrc for asdf configuration
* Create .tool-versions to specify Go version 1.24.1
* Update package.json to use asdf for development and build scripts
…mentation

* Add .tool-versions file to specify Go, Node.js, and pnpm versions
* Update Makefile to utilize new wrapper scripts for Go and pnpm commands
* Introduce setup target in Makefile for automated environment setup with asdf
* Revise development documentation to reflect new tool management options and installation instructions
* Create wrapper scripts for Go and pnpm to ensure consistent tool usage
@tafaust tafaust force-pushed the feature/asdf-golang branch from cb18e86 to f79f146 Compare October 7, 2025 06:17
Copy link
Owner

@0xfurai 0xfurai left a comment

Choose a reason for hiding this comment

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

Thanks a lot for your contribution!
The docs and dev setup definitely need some love — 100%.

I still have a few doubts about asdf in general since I haven’t used it much. The idea of using it for a multi-language project is great, but when I tried installing it on Ubuntu, it turned out I needed Go to build it — which kind of makes the whole effort a bit ironic 😄.

What do you think about it? Maybe devcontainers is a better choice to go?

@tafaust
Copy link
Contributor Author

tafaust commented Oct 9, 2025

Good point! I am on Mac and installed asdf as multi runtime manager via brew.
I have no experience with devcontainers. Should we support both? asdf is purely optional at this point.

Feedback incorporated.

* Change Node.js version from 22.0.0 to 20.18.0 (current LTS) in .tool-versions and server/.tool-versions
* Update package.json to reflect the new Node.js version requirement
* Revise development documentation to indicate the updated Node.js version
…pt and update Makefile

* Remove deprecated go.sh and pnpm.sh scripts
* Introduce tool.sh as a universal wrapper for executing commands with asdf or system binaries
* Update Makefile to utilize tool.sh for running Go and pnpm commands
* Revise development documentation to reflect changes in wrapper script usage
…entation

* Introduce 'dev' target in Makefile to streamline starting the development environment
* Update development documentation to recommend using 'make dev' for running the development stack
@tafaust tafaust requested a review from 0xfurai October 9, 2025 07:15
@0xfurai
Copy link
Owner

0xfurai commented Oct 9, 2025

So asdf very popular and is mostly for dev env, its also optional so I happy to see it in project

…ation

* Introduce 'install' target in Makefile for streamlined dependency installation
* Update development documentation to reflect new installation process and asdf integration
* Provide troubleshooting tips for common asdf issues and manual tool installation
@tafaust tafaust requested a review from 0xfurai October 10, 2025 01:37
@codecov
Copy link

codecov bot commented Oct 11, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 19.31%. Comparing base (a01404b) to head (b32f80e).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #202   +/-   ##
=======================================
  Coverage   19.31%   19.31%           
=======================================
  Files         170      170           
  Lines       18144    18144           
=======================================
  Hits         3504     3504           
  Misses      14479    14479           
  Partials      161      161           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@0xfurai 0xfurai merged commit 1336d6c into 0xfurai:main Oct 11, 2025
11 checks passed
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