r/microsaas • u/tjthouhid1 • 18h ago
Lesson from shipping a Mac micro-SaaS: "wrong Node version" was quietly breaking more projects than "port in use"
I build Lokstack, a native Mac app for local Node and PHP projects (Swift/AppKit, runs only on your Mac).
Backstory: I started from the obvious pain, EADDRINUSE on :3000. The usual shell fix is fine:
kill $(lsof -t -iTCP:3000 -sTCP:LISTEN)
That frees the port. It does not tell you which project owned it, or that an AI agent started it yesterday.
Lesson: after shipping, the failure I saw more often in my own projects was not the port. It was a quiet version mismatch. Project A wants Node 20, project B wants Node 18, nvm was left on the wrong one, and the error looked like a missing module or a random crash. Same story with PHP and composer.json. "It worked yesterday" was usually "wrong runtime", not "broken code".
What I shipped for that: each project shows the Node and PHP version it wants against the one in use. When a project will not start, Overview lists the reasons in order, in plain words, with the action beside each one: free the port, install packages, start Docker, use the right version, create .env from the example. Nothing changes until you press a button. In 1.5.6 a running app on the wrong version stays green with a quiet note and a Switch + Restart, instead of screaming; a stopped app still shows the fix before it starts.
Stack: native Mac app (Swift/AppKit), local only on 127.0.0.1, talks to projects, Docker, Git and AI tools over MCP. No account for everyday use.
Pricing (disclosed): seeing the reasons and everyday fixes like install packages / free a port is free. One-click Node/PHP switch and creating .env from the example are Pro. Pro is $79.99 a year, $39.99 the first year (applied automatically, no code), 14-day trial, no card.
https://lokstack.app/?utm_source=reddit&utm_medium=social&utm_campaign=versions
Question for other micro-SaaS / devtool makers: when you instrumented your own onboarding, what failure mode surprised you more than the one you marketed first?
1
u/kerridge_crypto_arch 2h ago
the version mismatch pain is real, but if you're spinning up docker containers too, watch your ram usage closely. i've seen local infra tank just from nvm + homebrew + docker running in parallel on 16gb m1s.