Workbench

.devcontainer/devcontainer.json

@@ -1,4 +1,3 @@
-// https://aka.ms/devcontainer.json
 {
 	"name": "Existing Docker Compose (Extend)",
 	"dockerComposeFile": [
@@ -9,18 +8,8 @@
 	"settings": {},
 	"extensions": [
         "editorconfig.editorconfig",
-        "ryannaddy.laravel-artisan",
-        "amiralizadeh9480.laravel-extra-intellisense",
-        "stef-k.laravel-goto-controller",
-        "codingyu.laravel-goto-view",
-        "mikestead.dotenv",
-        "christian-kohler.path-intellisense",
-        "esbenp.prettier-vscode",
-        "CoenraadS.bracket-pair-colorizer"
 	],
 	"remoteUser": "sail",
-	"postCreateCommand": "chown -R 1000:1000 /var/www/html && composer install && php artisan key:generate",
-	"forwardPorts": [80]
-	// "runServices": [],
-	// "shutdownAction": "none",
+	"postCreateCommand": "chown -R 1000:1000 /var/www/html && composer install",
+	"forwardPorts": [8000]
 }

.github/instructions/instructions.md

@@ -0,0 +1,104 @@
+---
+applyTo: '**'
+---
+
+# Waterline Development Quick Reference
+
+## Prerequisites
+- PHP 8.0.2+
+- Node.js & npm
+- Composer
+- Chrome/Chromium (for browser debugging)
+
+## Setup & Development
+1. Install dependencies:
+   ```bash
+   composer install
+   npm install
+   ```
+2. Build assets:
+   ```bash
+   npm run production
+   ```
+3. Publish assets to testbench:
+   ```bash
+   ./vendor/bin/testbench waterline:publish
+   ```
+4. Run migrations:
+   ```bash
+   ./vendor/bin/testbench workbench:create-sqlite-db
+   ./vendor/bin/testbench migrate:fresh --database=sqlite
+   ```
+5. Start server:
+   ```bash
+   composer run serve
+   ```
+6. Access dashboard:
+   - Local: http://localhost:8000/waterline
+7. Create test workflow:
+   ```bash
+   ./vendor/bin/testbench workflow:create-test
+   ```
+8. Run queue worker:
+   ```bash
+   ./vendor/bin/testbench queue:work
+   ```
+
+## Asset Management
+- Source: `resources/js/`, `resources/sass/`
+- Build: `npm run production`
+- Publish: `./vendor/bin/testbench waterline:publish`
+
+## Key Commands
+- Build workbench: `composer run build`
+- Start server: `composer run serve`
+- Publish assets: `./vendor/bin/testbench waterline:publish`
+- Run tests: `composer test`
+- Debug browser: `node .github/tools/browser.js`
+
+## Troubleshooting
+- Mix manifest not found: rebuild and publish assets
+- Blank dashboard: check JS errors, publish assets, run debug script
+- Connection issues: ensure server is running, check URL
+- Puppeteer/browser errors: install Chrome/Chromium, check debug script
+
+## File Structure
+- `app/` - PHP source
+- `config/` - Package config
+- `resources/` - JS, Sass, Blade
+- `public/` - Built assets
+- `routes/` - Package routes
+- `tests/` - Test suite
+- `.github/tools/` - Debugging scripts
+
+## Config Files
+- `testbench.yaml` - Testbench config
+- `webpack.mix.js` - Asset build config
+- `composer.json` - Dependencies/scripts
+- `config/waterline.php` - Package config
+
+## Checklist
+- composer install && npm install
+- npm run production
+- ./vendor/bin/testbench waterline:publish
+- ./vendor/bin/testbench workbench:create-sqlite-db
+- ./vendor/bin/testbench migrate:fresh --database=sqlite
+- composer run serve
+- ./vendor/bin/testbench workflow:create-test
+- ./vendor/bin/testbench queue:work
+- node .github/tools/browser.js
+
+## Success Output
+Working install should show:
+```
+{
+  "title": "Waterline - Dashboard",
+  "elementExists": true,
+  "hasVueInstance": true,
+  "windowWaterline": true,
+  "waterlineConfig": {
+    "path": "waterline",
+    "basePath": "/waterline"
+  }
+}
+```