LocalWrap v3.3.0

Added

• Workspace Doctor checks the selected workspace/profile for first-green-run blockers and warnings across directories, commands, dependency folders, .env.example gaps, duplicate or busy ports, and local URLs.
• Start Ready starts only Workspace Doctor projects without blocking failures, skipping blocked services instead of forcing a full-stack start.

LocalWrap v3.2.0

Added

• Team workspace packs can now be imported from and exported to .localwrap/workspace.json, giving repos a portable, reviewable way to define LocalWrap projects and named workspace profiles.

2.6.0

v2.6.0

Prepare v2.6.0 release

2.5.0 - introducing Project Doctor

LocalWrap v2.5.0

LocalWrap 2.5.0 focuses on trust in the first few minutes: importing a project, starting it, seeing what is happening, and knowing what to do when something does not respond.

Since v2.3.0, LocalWrap now has guided project import, inline validation, clearer runtime states, better logs, improved tray actions, a built-in sample project, and the new Project Doctor.

Highlights

• Added Project Doctor, an always-visible diagnostic panel above logs.
• Added guided project import: pick a folder first, then LocalWrap suggests name, command, port, and URL.
• Added inline validation for directories, commands, ports, local URLs, port mismatches, and busy ports.
• Added clearer runtime states: starting, ready, running but not responding, failed, stopped, and stopping.
• Added safer troubleshooting actions: find a free port, sync URL to port, reveal directory, reveal command, and copy diagnostics.
• Added a dependency-free sample project under examples/sample-project for demos and smoke testing.

Project Doctor

Project Doctor checks the things users usually wonder about when a project will not start cleanly:

• Project directory
• Launch command
• Dependency folder presence
• Port availability
• Local URL validity
• Process start
• Readiness response

It also keeps a short timeline of recent events, including preflight checks, command start, readiness waiting, ready state, timeout, process errors, and exits.

Doctor actions are intentionally safe. LocalWrap can suggest fixes and update fields, but it does not run installs, Docker commands, plugins, cloud sync, or arbitrary shell commands.

First-Run Improvements

The empty state is now action-first: users are guided toward Add Project instead of facing a dense blank form.

When importing a folder, LocalWrap inspects package.json, prefers common scripts like dev, start, preview, and serve, then fills in useful defaults. Save and Start stay disabled until required fields are valid.

Changing the port now updates the generated URL automatically unless the user has intentionally edited the URL.

Logs And Runtime Clarity

Logs now include controls to clear, copy, and reveal the command. Runtime state now preserves useful session details such as last exit code, start/stop timestamps, readiness messages, and diagnosis state.

Readiness timeouts are now shown as “running but not responding” instead of being treated as a simple failure.

Tray Improvements

The tray menu is more useful for day-to-day project launching:

• Open all ready projects
• Stop all running projects
• Per-running-project controls
• Existing update, about, and quit actions remain unchanged

Demo Project

This release adds examples/sample-project, a dependency-free local app that can be imported into LocalWrap to test project inspection, start/stop/restart, readiness, logs, Project Doctor, and browser opening without needing another repo.

Reliability And Maintenance

• Existing v2.3 project configs remain compatible; no migration is required.
• Privileged actions remain IPC-only.
• URLs remain restricted to local http/https targets.
• Command execution remains allowlisted.
• Test coverage was expanded across project inspection, validation, lifecycle state, Project Doctor, renderer behavior, preload IPC, and the sample project.
• CI actions and Electron/Jest

v2.3.0 - introducing Project Launcher

Summary

Implements the LocalWrap v2.3 project launcher upgrade.

This changes LocalWrap from a localhost-hosted server control panel into an Electron-only desktop launcher for saved local development projects. Projects can now store directory, command, port, URL, autostart, and open-on-ready settings, with process control, readiness tracking, and bounded live logs.

Key Changes

• Load the app UI with Electron loadFile() instead of serving it from an Express localhost control server.
• Add persisted project storage under Electron userData.
• Add project lifecycle management for start, stop, restart, readiness polling, log buffering, and process cleanup.
• Replace the old server control UI with a project dashboard.
• Add package script discovery for selected directories.
• Move privileged actions behind preload IPC only.
• Expand local URL validation to http/https localhost, 127.0.0.1, and ::1.
• Remove no-longer-needed Express, Helmet, and rate-limit runtime dependencies.
• Update README, changelog, security docs, package metadata, CI, and Jest config.

Tests

• npm test
• npm run lint
• npm run format:check
• git diff --check
• Electron startup smoke test via npm start

2.1.0

What's Changed

• Run dev scripts + CSP renderer fix (v2.1.0) by @tcballard

v2.0.0 - Open Source / MIT licensed

LocalWrap is now free and open source under the MIT license.

Why the pivot?
I originally explored shipping LocalWrap as a small paid product, with a license and a "buy a license" model. Having lived with that for a while, the honest truth was that the licensing overhead just wasn't worth it. I think maybe one or two people bothered...

A few reasons:

• It's a developer tool, and developers tinker: the whole point of LocalWrap is convenience for people running local servers. Locking that behind a license key and an activation flow added friction to the exact audience most likely to want to read, fork, and improve it.

• The maintenance/licensing machinery cost more than it returned: license enforcement, a purchase site, and the legal fuss around a one-person project added work without making the tool any better.

• Open source makes it more trustworthy: this app wraps your local dev servers and ships with a hardened Electron + CSP + rate-limiting setup. "Trust me, it's secure" is a lot weaker than "here's the source — read it yourself."

I'd rather it get used and improved than sit behind a paywall. MIT means anyone can use it, fork it, or contribute back, no strings attached.

So that's the change: no license keys, no trials, no gating - just the app.

What's in this release

• Prebuilt installers for Windows (.exe), macOS (.dmg), and Linux (.AppImage)

• Multi-server localhost management, system-tray integration, and a secure-by-default Electron foundation.

Note: these installers aren't code-signed yet, so Windows SmartScreen and macOS Gatekeeper will warn about an "unknown developer." On Windows: More info → Run anyway. On macOS: right-click the app → Open the first time.

Thanks

Issues, ideas, and pull requests are all welcome - see the relevant .md files for guidance.