stackenv 0.1.2

Native, zero-container multi-project dev environment manager. No Docker, no VMs.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

# stack

**Native, zero-container multi-project dev environment manager. No Docker, no VMs.**

stack runs your project's languages, databases, and dev server as plain
child processes and routes a real local domain to whichever one you're
working on — no containers, no idle hypervisor, nothing running you didn't
ask for.

**Windows — available now** (PowerShell & cmd) · macOS — coming soon · Linux — coming soon

[Documentation](https://sanayavo.com/stack/) · [Examples](examples) · [Changelog](https://sanayavo.com/stack/changelog.html)

## Quick look

```toml
# stack.toml
[project]
name = "acme-api"

[language]
php = "8.3.1"

[service.mysql]
version = "8.0.35"

[run]
command = "php -S 127.0.0.1:{port} -t public"
```

```shell
$ stack up
Loaded C:\Users\you\acme-api\stack.toml
  project: acme-api
  domain: acme-api.localhost
  languages: ["php"]
  services: ["mysql"]
  php: C:\Users\you\.vfox\cache\php\v-8.3.1\...\php.exe -> PHP 8.3.1 (cli)
  service.mysql: started (pid 41232, port 3306)
  run: php -S 127.0.0.1:52140 -t public  (pid 41244, port 52140)
  routed: http://acme-api.localhost -> 127.0.0.1:52140
```

Every project pinning the same language+version shares one binary from a
central store — nothing copied per project. Every project pinning the same
service+version shares one running instance, isolated by schema.

## Install

```shell
irm https://github.com/sanayasfp/stack/releases/latest/download/stackenv-installer.ps1 | iex
```

or `cargo install stackenv` (published under `stackenv` since `stack` was already taken on crates.io — it still installs a `stack` command), or grab the zip directly from the [latest release](https://github.com/sanayasfp/stack/releases/latest).

winget/Scoop/Chocolatey packages are coming soon — not published yet. See [Getting Started](https://sanayavo.com/stack/getting-started.html) for the full list once they land.

Then, once:

```shell
stack setup
```

Wires the shell hook and installs the tools stack delegates to (vfox, uv,
Caddy) at pinned, tested versions.

## Why not Docker

Containers solve "works on every machine" by shipping an entire OS layer
per project. stack solves the same problem differently: pin exact versions
per project through the version managers you'd install anyway (vfox, uv),
share one binary across every project at that version, and run everything
as plain processes — no virtualization overhead, no idle daemon between
projects.

## License

Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or
[MIT license](LICENSE-MIT) at your option.