chore: wip

Author: chrisbbreuer

README.md

@@ -26,7 +26,7 @@ Launchpad is a comprehensive dependency management solution that bridges the gap
 - Version-specific tool installation
 - Seamless switching between project contexts
 
-At its core, Launchpad leverages pkgx's powerful package ecosystem while adding intelligent management, environment isolation, and developer-friendly workflows.
+At its core, Launchpad leverages pkgx's powerful package ecosystem, the Pantry, while adding intelligent management, environment isolation, and developer-friendly workflows. Learn more in the docs: [Why Launchpad](https://stacks-launchpad.netlify.app/why), [Quickstart](https://stacks-launchpad.netlify.app/quickstart).
 
 ## Features
 
@@ -39,7 +39,7 @@ Launchpad transforms how you manage dependencies across your entire development
 - 🪟 **Cross-Platform Support** — Consistent experience across macOS, Linux, and Windows
 
 ### Service Management
-- ⚡ **19+ Pre-configured Services** — PostgreSQL, Redis, Kafka, Prometheus, Grafana, Vault, and more
+- ⚡ **30+ Pre-configured Services** — PostgreSQL, Redis, Kafka, Prometheus, Grafana, Vault, and more
 - 🚀 **One-Command Service Control** — Start, stop, restart services with automatic configuration
 - 🏥 **Health Monitoring** — Built-in health checks with automatic status detection
 - 🔧 **Auto-Configuration** — Default configuration files generated for each service
@@ -48,7 +48,7 @@ Launchpad transforms how you manage dependencies across your entire development
 
 ### Project-Aware Environment Management
 - 🌍 **Automatic Environment Isolation** — Project-specific environments that activate when you enter a project directory
-- 🎯 **Dependency Detection** — Automatically reads `dependencies.yaml`, `package.json`, and other project files
+- 🎯 **Dependency Detection** — Automatically reads `deps.yaml`, `dependencies.yaml`, `package.json`, `pyproject.toml`, and other project files
 - 🔄 **Context Switching** — Seamlessly switch between different project environments
 - 📋 **Version Management** — Install and manage specific versions of tools per project
 - 🗂️ **Environment Management** — List, inspect, clean, and remove project environments with readable identifiers
@@ -124,7 +124,7 @@ yarn global add @stacksjs/launchpad
 pnpm add -g @stacksjs/launchpad
 ```
 
-See [Installation Guide](https://github.com/stacksjs/launchpad/tree/main/docs/install.md) for more options.
+See [Installation Guide](https://stacks-launchpad.netlify.app/install) for more options.
 
 ## Quick Start
 
@@ -203,8 +203,13 @@ cd ..
 # → 🔄 Environment deactivated
 ```
 
+Learn more: [Environment Management](https://stacks-launchpad.netlify.app/features/environment-management), [Package Management](https://stacks-launchpad.netlify.app/features/package-management), [Configuration](https://stacks-launchpad.netlify.app/config), [FAQ](https://stacks-launchpad.netlify.app/faq).
+
 **Supported Project Files:**
+- `deps.yaml` / `deps.yml`
 - `dependencies.yaml` / `dependencies.yml`
+- `launchpad.yaml` / `launchpad.yml`
+- `pkgx.yaml` / `pkgx.yml`
 - `package.json` (Node.js projects)
 - `pyproject.toml` (Python projects)
 - `Cargo.toml` (Rust projects)
@@ -219,7 +224,7 @@ Manage your project environments with human-readable identifiers:
 launchpad env:list
 
 # Inspect a specific environment
-launchpad env:inspect my-project_1a2b3c4d
+launchpad env:inspect my-project_1a2b3c4d-d89abc12
 
 # Clean up old or failed environments
 launchpad env:clean --dry-run
@@ -228,10 +233,10 @@ launchpad env:clean --dry-run
 launchpad env:remove old-project_5e6f7g8h --force
 ```
 
-**Environment Hash Format:** `{project-name}_{8-char-hex}`
-- `final-project_7db6cf06` - Easy to identify and manage
-- `working-test_208a31ec` - Human-readable project identification
-- `my-app_1a2b3c4d` - Collision-resistant unique identifiers
+**Environment Hash Format:** `{project-name}_{8-char-hex}-d{8-char-dep-hash}`
+- `final-project_7db6cf06-d89abc12` - Project path hash plus dependency fingerprint
+- `working-test_208a31ec-d1029a7b` - Human-readable with version-aware suffix
+- `my-app_1a2b3c4d-deadbeef` - Collision-resistant, version-switching on cd
 
 ### Package Management
 
@@ -416,12 +421,12 @@ See [GitHub Action Documentation](https://github.com/stacksjs/launchpad/tree/mai
 
 Explore advanced dependency management topics:
 
-- [Service Management](https://github.com/stacksjs/launchpad/tree/main/docs/features/service-management.md)
-- [Project Environment Configuration](https://github.com/stacksjs/launchpad/tree/main/docs/features/package-management.md)
-- [Custom Shims and Tool Management](https://github.com/stacksjs/launchpad/tree/main/docs/advanced/custom-shims.md)
-- [Cross-platform Compatibility](https://github.com/stacksjs/launchpad/tree/main/docs/advanced/cross-platform.md)
-- [Performance Optimization](https://github.com/stacksjs/launchpad/tree/main/docs/advanced/performance.md)
-- [API Reference](https://github.com/stacksjs/launchpad/tree/main/docs/api/reference.md)
+- [Service Management](https://stacks-launchpad.netlify.app/features/service-management)
+- [Project Environment Configuration](https://stacks-launchpad.netlify.app/features/package-management)
+- [Custom Shims and Tool Management](https://stacks-launchpad.netlify.app/advanced/custom-shims)
+- [Cross-platform Compatibility](https://stacks-launchpad.netlify.app/advanced/cross-platform)
+- [Performance Optimization](https://stacks-launchpad.netlify.app/advanced/performance)
+- [API Reference](https://stacks-launchpad.netlify.app/api/reference)
 
 ## Comparing to Alternatives
 

docs/migration.md

@@ -111,7 +111,7 @@ brew uninstall node python go rust
 
 | Homebrew | Launchpad | Notes |
 |----------|-----------|-------|
-| `brew install node` | `launchpad install node@22` | Launchpad requires version specification |
+| `brew install node` | `launchpad install node` or `launchpad install node@22` | Versions are optional; pin them when you need determinism |
 | `brew uninstall node` | `launchpad remove node` | Launchpad removes all versions by default |
 | `brew list` | `launchpad list` | Both show installed packages |
 | `brew upgrade` | N/A | Launchpad uses immutable packages |

docs/quickstart.md

@@ -1,6 +1,6 @@
 # Quick Start
 
-Get up and running with Launchpad in under 5 minutes! This guide will help you install, configure, and start using Launchpad right away.
+This guide will help you install, configure, and start using Launchpad right away.
 
 ## 1. Install Launchpad
 
@@ -38,9 +38,9 @@ This command will:
 - ✅ Configure your PATH automatically
 - ✅ Set up shell integration for automatic environment activation
 
-## 3. Set Up Shell Integration
+## 3. (Optional) Set Up Shell Integration
 
-Enable automatic environment activation for project directories:
+Shell integration is installed automatically when you run `launchpad bootstrap` (unless you pass `--skip-shell-integration`). If you skipped bootstrap or want to set it up manually, run:
 
 ```bash
 # Add to your shell configuration (zsh)
@@ -104,7 +104,7 @@ launchpad list
 🎉 **Congratulations!** You've just:
 
 1. **Installed Launchpad** - A modern package manager that works alongside your existing tools
-2. **Bootstrapped your system** - Set up pkgx, Bun, and shell integration
+2. **Bootstrapped your system** - Set up pkgx, Bun, and (optionally) shell integration
 3. **Created your first environment** - Project-specific isolation with automatic activation
 4. **Installed packages** - Node.js and TypeScript are now available in your project
 

docs/why.md

@@ -19,7 +19,10 @@ Launchpad is a CLI and TypeScript library designed to solve these problems by pr
 - **Isolated packages**: Install only what you need without affecting other dependencies
 - **Automatic PATH management**: Easily access installed tools from anywhere
 - **Consistent interface**: Same commands work across macOS, Linux, and Windows
-- **Dev environments**: Dedicated support for project-specific development environments
+- **Project-aware dev environments**: Automatic activation in project directories with version-aware isolation
+- **Version switching on cd**: Environments are derived from a project hash plus a dependency fingerprint, so changing versions in `deps.yaml` selects a new env automatically
+
+Learn more: [Quickstart](https://stacks-launchpad.netlify.app/quickstart), [Environment Management](https://stacks-launchpad.netlify.app/features/environment-management), [Package Management](https://stacks-launchpad.netlify.app/features/package-management).
 
 ## Key Advantages
 
@@ -53,15 +56,19 @@ Launchpad is built with the developer experience in mind. It provides a clean, i
 # Install Node.js in seconds
 launchpad install node@22
 
-# Create a dedicated environment for a project
+# Create a project environment (auto-activates on cd)
+echo "dependencies:\n  - node@22" > deps.yaml
+cd /path/to/project   # ✅ Environment activates automatically
+
+# Or force activation manually (without cd)
 launchpad dev:on
 
-# Bootstrap development environment
+# Bootstrap development environment (installs shell integration, etc.)
 launchpad bootstrap
 ```
 
 ## Why Now?
 
-As software development becomes increasingly complex, the tools we use to manage our environments should become simpler. Launchpad represents a modern approach to package management that embraces isolation, speed, and cross-platform compatibility. This software is by the team that created Stacks.js, and in order to automated the onboarding process, we needed a better package manager.
+As software development becomes increasingly complex, the tools we use to manage our environments should become simpler. Launchpad represents a modern approach to package management that embraces isolation, speed, and cross-platform compatibility. This software is by the team that created Stacks.js, and in order to automate the onboarding process, we needed a better package manager.
 
-By building on top of pkgx and focusing on the developer experience, Launchpad provides a powerful yet intuitive solution for managing packages and development environments in a way that's sustainable for the future of software development.
+By building on top of pkgx's Pantry and focusing on the developer experience, Launchpad provides a powerful yet intuitive solution for managing packages and development environments in a way that's sustainable for the future of software development.