chore: wip

Author: chrisbbreuer

README.md

@@ -283,6 +283,23 @@ launchpad service enable postgres redis
 - **API & Backend**: Hasura, Keycloak
 - **Caching**: Memcached, Elasticsearch
 
+#### Configure services in deps.yaml
+
+Add services to your dependency file to auto-start when the project environment activates:
+
+```yaml
+# deps.yaml
+dependencies:
+  - node@22
+  - postgresql@15
+
+services:
+  enabled: true
+  autoStart:
+    - postgres
+    - redis
+```
+
 #### Database Configuration
 
 Customize database credentials for all database services:

docs/api/reference.md

@@ -543,6 +543,71 @@ await dump('/path/to/project', { dryrun: false, quiet: false })
 // - Install [email protected] globally (individual flag)
 ```
 
+### Services in dependencies.yaml
+
+Launchpad can read a `services` section from your dependency file to automatically start services on environment activation.
+
+```yaml
+# deps.yaml
+dependencies:
+  bun: ^1.2.19
+  node: ^22.17.0
+  php: ^8.4.11
+  composer: ^2.8.10
+  postgres: ^17.2.0
+  redis: ^8.0.4
+
+services:
+  enabled: true
+  autoStart:
+    - postgres
+    - redis
+```
+
+At runtime, the environment generator detects `services.enabled` and starts each service in `autoStart`.
+
+#### Inference shorthand
+
+For Stacks & Laravel projects, you can also use a shorthand to infer services from `.env`:
+
+```yaml
+# deps.yaml
+dependencies:
+  php: ^8.4.11
+  postgres: ^17.2.0
+  redis: ^8.0.4
+
+services:
+  infer: true
+```
+
+This will auto-start services based on `.env` (e.g., `DB_CONNECTION=pgsql` and `CACHE_DRIVER=redis` → `postgres` and `redis`).
+
+Project-level post-setup commands can be configured via top-level `postSetup` in `launchpad.config.ts`:
+
+```ts
+// launchpad.config.ts
+import type { LaunchpadConfig } from '@stacksjs/launchpad'
+
+const config: LaunchpadConfig = {
+  postSetup: {
+    enabled: true,
+    commands: [
+      {
+        name: 'migrate',
+        command: 'php artisan migrate',
+        description: 'Run database migrations',
+        condition: 'hasUnrunMigrations',
+        runInBackground: false,
+        required: false,
+      },
+    ],
+  },
+}
+
+export default config
+```
+
 ### Global Flag Resolution Examples
 
 ```typescript

docs/config.md

@@ -338,6 +338,58 @@ dependencies:
 
 This ensures that essential tools like shells, package managers, and system utilities are preserved during cleanup operations, preventing system breakage.
 
+### Service Management in dependencies.yaml
+
+Define services that should automatically start for your project:
+
+```yaml
+# deps.yaml
+dependencies:
+  bun: ^1.2.19
+  node: ^22.17.0
+  php: ^8.4.11
+  composer: ^2.8.10
+  postgres: ^17.2.0
+  redis: ^8.0.4
+
+services:
+  enabled: true
+  autoStart:
+    - postgres
+    - redis
+```
+
+Behavior:
+- **enabled**: toggles service management for the project.
+- **autoStart**: array of service names to start automatically on environment activation.
+- Service names must match those in the Supported Services list (e.g. `postgres`, `redis`, `nginx`).
+
+#### Inference shorthand
+
+You can enable a shorthand for framework-based projects (e.g., Laravel) to infer services automatically:
+
+```yaml
+# deps.yaml
+dependencies:
+  php: ^8.4.11
+  postgres: ^17.2.0
+  redis: ^8.0.4
+
+services:
+  infer: true
+```
+
+When enabled and a Laravel app is detected (`artisan` present), Launchpad will read `.env` and infer services:
+- `DB_CONNECTION=pgsql` → `postgres`
+- `DB_CONNECTION=mysql|mariadb` → `mysql`
+- `CACHE_DRIVER=redis` or `CACHE_STORE=redis` → `redis`
+- `CACHE_DRIVER=memcached` or `CACHE_STORE=memcached` → `memcached`
+
+Environment toggles:
+- `LAUNCHPAD_FRAMEWORKS_ENABLED` (default: true)
+- `LAUNCHPAD_SERVICES_INFER` (default: true)
+- `LAUNCHPAD_LARAVEL_ENABLED` (default: true)
+
 ## Configuration Options
 
 ### General Options
@@ -391,6 +443,34 @@ This ensures that essential tools like shells, package managers, and system util
 | `services.autoRestart` | boolean | `true` | Auto-restart failed services |
 | `services.startupTimeout` | number | `30` | Service startup timeout in seconds |
 | `services.shutdownTimeout` | number | `10` | Service shutdown timeout in seconds |
+| `services.infer` | boolean | `true` | Derive services to auto-start from framework configuration |
+
+### Post-Setup Commands
+
+Configure commands to run after the environment is prepared (independent of services):
+
+```ts
+// launchpad.config.ts
+import type { LaunchpadConfig } from '@stacksjs/launchpad'
+
+const config: LaunchpadConfig = {
+  postSetup: {
+    enabled: true,
+    commands: [
+      {
+        name: 'migrate',
+        command: 'php artisan migrate',
+        description: 'Run database migrations',
+        condition: 'hasUnrunMigrations',
+        runInBackground: false,
+        required: false,
+      },
+    ],
+  },
+}
+
+export default config
+```
 
 ## Environment Variables
 

docs/examples.md

@@ -838,9 +838,11 @@ dependencies:
   - [email protected]
 
 services:
-  - postgres
-  - redis
-  - nginx
+  enabled: true
+  autoStart:
+    - postgres
+    - redis
+    - nginx
 
 env:
   DATABASE_URL: postgresql://localhost:5432/myapp

docs/features/service-management.md

@@ -35,6 +35,53 @@ launchpad service list
 launchpad service restart redis
 ```
 
+## Configure Services in dependencies.yaml
+
+You can declare services in your project `deps.yaml`/`dependencies.yaml` to auto-start when your environment activates:
+
+```yaml
+# deps.yaml
+dependencies:
+  bun: ^1.2.19
+  node: ^22.17.0
+  php: ^8.4.11
+  composer: ^2.8.10
+  postgres: ^17.2.0
+  redis: ^8.0.4
+
+services:
+  enabled: true
+  autoStart:
+    - postgres
+    - redis
+```
+
+### Shorthand: services.infer: true
+
+For Stacks & Laravel projects, you can enable a shorthand that auto-detects DB & cache from your `.env` and auto-starts the right services:
+
+```yaml
+# deps.yaml
+dependencies:
+  php: ^8.4.11
+  postgres: ^17.2.0
+  redis: ^8.0.4
+
+# Shorthand that infers services from Stacks/Laravel .env
+services:
+  infer: true
+```
+
+Behavior:
+- Reads `DB_CONNECTION` and `CACHE_DRIVER` or `CACHE_STORE` from `.env` when a Stacks or Laravel app is detected (`buddy` or `artisan` present).
+- Maps to services: `pgsql` → `postgres`, `mysql`/`mariadb` → `mysql`, `redis` → `redis`, `memcached` → `memcached`.
+- Equivalent to specifying `services.enabled: true` with an `autoStart` list of detected services.
+- Can be disabled via env: set `LAUNCHPAD_AUTO_START_FROM_FRAMEWORK=false`.
+
+Notes:
+- **services.enabled**: turn service management on for the project.
+- **services.autoStart**: list of services to start automatically (supported values are listed below in Available Services). These start when the environment activates (e.g. upon `cd` into the project with shell integration).
+
 ## Available Services
 
 Launchpad includes pre-configured definitions for these services:
@@ -699,14 +746,16 @@ Services are automatically initialized on first start:
 Service management integrates well with project environments:
 
 ```yaml
-# dependencies.yaml
+# deps.yaml
 dependencies:
   - node@22
   - postgresql@15
 
 services:
-  - postgres
-  - redis
+  enabled: true
+  autoStart:
+    - postgres
+    - redis
 
 env:
   DATABASE_URL: postgresql://localhost:5432/myapp

packages/launchpad/src/config.ts

@@ -50,6 +50,10 @@ export const defaultConfig: LaunchpadConfig = {
   useRegistry: true,
   installMethod: 'curl',
   installPath: getDefaultInstallPath(),
+  postSetup: {
+    enabled: process.env.LAUNCHPAD_POST_SETUP_ENABLED === 'true',
+    commands: [],
+  },
   services: {
     enabled: process.env.LAUNCHPAD_SERVICES_ENABLED !== 'false',
     dataDir: process.env.LAUNCHPAD_SERVICES_DATA_DIR || path.join(homedir(), '.local', 'share', 'launchpad', 'services'),
@@ -58,6 +62,7 @@ export const defaultConfig: LaunchpadConfig = {
     autoRestart: process.env.LAUNCHPAD_SERVICES_AUTO_RESTART !== 'false',
     startupTimeout: Number.parseInt(process.env.LAUNCHPAD_SERVICES_STARTUP_TIMEOUT || '30', 10),
     shutdownTimeout: Number.parseInt(process.env.LAUNCHPAD_SERVICES_SHUTDOWN_TIMEOUT || '10', 10),
+    infer: process.env.LAUNCHPAD_SERVICES_INFER !== 'false',
     database: {
       username: process.env.LAUNCHPAD_DB_USERNAME || 'root',
       password: process.env.LAUNCHPAD_DB_PASSWORD || 'password',
@@ -68,43 +73,6 @@ export const defaultConfig: LaunchpadConfig = {
       laravel: {
         enabled: process.env.LAUNCHPAD_LARAVEL_ENABLED !== 'false',
         autoDetect: process.env.LAUNCHPAD_LARAVEL_AUTO_DETECT !== 'false',
-        postSetup: {
-          enabled: process.env.LAUNCHPAD_LARAVEL_POST_SETUP !== 'false',
-          commands: [
-            {
-              name: 'migrate',
-              command: 'php artisan migrate',
-              description: 'Run database migrations',
-              condition: 'hasUnrunMigrations',
-              runInBackground: false,
-              required: false,
-            },
-            {
-              name: 'seed',
-              command: 'php artisan db:seed',
-              description: 'Seed the database with sample data',
-              condition: 'hasSeeders',
-              runInBackground: false,
-              required: false,
-            },
-            {
-              name: 'storage-link',
-              command: 'php artisan storage:link',
-              description: 'Create symbolic link for storage',
-              condition: 'needsStorageLink',
-              runInBackground: false,
-              required: false,
-            },
-            {
-              name: 'optimize',
-              command: 'php artisan optimize',
-              description: 'Optimize Laravel for production',
-              condition: 'isProduction',
-              runInBackground: false,
-              required: false,
-            },
-          ],
-        },
       },
       stacks: {
         enabled: process.env.LAUNCHPAD_STACKS_ENABLED !== 'false',

packages/launchpad/src/dev/dump.ts

@@ -199,10 +199,10 @@ export async function detectLaravelProject(dir: string): Promise<{ isLaravel: bo
     // Ignore errors checking migrations
   }
 
-  // Execute post-setup commands if enabled (skip in shell integration; handled later with full env)
-  const laravelConfig = config.services?.frameworks?.laravel
-  if (laravelConfig?.postSetup?.enabled && process.env.LAUNCHPAD_SHELL_INTEGRATION !== '1') {
-    const postSetupResults = await executepostSetup(dir, laravelConfig.postSetup.commands || [])
+  // Execute project-level post-setup commands if enabled (skip in shell integration)
+  const projectPostSetup = config.postSetup
+  if (projectPostSetup?.enabled && process.env.LAUNCHPAD_SHELL_INTEGRATION !== '1') {
+    const postSetupResults = await executepostSetup(dir, projectPostSetup.commands || [])
     suggestions.push(...postSetupResults)
   }
 
@@ -1205,8 +1205,8 @@ async function createPhpShimsAfterInstall(envDir: string): Promise<void> {
  */
 async function maybeRunLaravelPostSetup(projectDir: string, envDir: string, _isShellIntegration: boolean): Promise<void> {
   try {
-    const laravelConfig = config.services?.frameworks?.laravel
-    if (!laravelConfig?.postSetup?.enabled) {
+    const projectPostSetup = config.postSetup
+    if (!projectPostSetup?.enabled) {
       return
     }
 
@@ -1225,7 +1225,7 @@ async function maybeRunLaravelPostSetup(projectDir: string, envDir: string, _isS
     catch {}
 
     // Execute and mark
-    const results = await executepostSetup(projectDir, laravelConfig.postSetup.commands || [])
+    const results = await executepostSetup(projectDir, projectPostSetup.commands || [])
     if ((results && results.length > 0) || true) {
       try {
         fs.writeFileSync(markerFile, new Date().toISOString())