feat: Dashboard v2 - Full CRUD, Information-Rich UI, and Documentation (#28)

* feat: add Vue SPA dashboard foundation (WIP)

* feat: complete Vue SPA dashboard with command palette and secure env vars

- Add command palette (Cmd+K) with quick actions for deploy, restart,
  logs, open in Coolify, live site, GitHub, and resource management
- Add toast notification system with success/error/warning/info types
- Add secure environment variables with automatic masking for sensitive
  keys (PASSWORD, SECRET, TOKEN, KEY, etc.) and reveal toggle
- Add Coolify deep links throughout (app header, resource cards, sidebar)
- Consolidate pages: Dashboard, Deployments, Configuration (tabbed), Logs
- Add search/filter for environment variables
- Update SPA routing with catch-all for client-side navigation
- Add comprehensive tests for env vars and database operations
- Update Docker generator to handle wayfinder in CI/Docker builds
- Improve install/provision command output and CLI formatting

Stu Mason + AI <me@stumason.dev>

* feat: add multi-environment switcher and backup toast notifications

Add EnvironmentController with endpoints to list and switch between
configured environments (dev, staging, production). Create EnvironmentSwitcher
Vue component in sidebar that shows current environment and allows switching.

Add toast notifications to backup trigger for better user feedback.

Stu Mason + AI <me@stumason.dev>

* fix: align API with Coolify - env vars and backup schedules

- Remove is_build_time field from env var creation (Coolify doesn't support it)
- Remove non-existent backup trigger endpoint (POST /databases/{uuid}/backup)
- Implement proper backup schedule display with executions
- Update backups() repository method to fetch schedules with their executions
- Update tests to match new backup API structure

Stu Mason + AI <me@stumason.dev>

* fix: remove is_build_time checkboxes from env var forms

The Coolify API doesn't support is_build_time field. Remove the
UI elements that were still binding to it via v-model.

Stu Mason + AI <me@stumason.dev>

* feat: complete dashboard v2 with full CRUD and information-rich UI

Dashboard Enhancements:
- Hero status card with animated health indicators
- Deployment info bar (branch, commit, last deploy, project)
- One-click deploy with dropdown (latest, force, specific commit)
- Database/cache cards with internal host and public port info
- Recent deployments with inline accordion build logs
- Lazy-loaded logs with 6-line preview and "See more" expansion
- Color-coded stdout/stderr with line numbers
- GitHub integration (commit links, branch links, repo links)
- Coolify deep links to resources

Bug Fixes:
- Fix env var update 404 (was missing envUuid in URL path)
- Fix deployment logs endpoint response format
- Fix project/environment not displaying (fetch from API)

New Features:
- Backup schedule CRUD for databases
- Environment multi-switcher in Configuration
- Toast notifications for backup operations
- Database start/stop/restart from Resources page

API Changes:
- ApplicationRepository::updateEnv() now takes envUuid parameter
- DatabaseRepository::createBackup/updateBackup/deleteBackup added
- DashboardStatsController returns project, environment, server data

Documentation:
- Complete README rewrite with badges and screenshot
- Dashboard overview docs with all features documented
- Landing page with feature cards and quick start

Stu Mason + AI <me@stumason.dev>

* fix: add input validation to controllers (PR review feedback)

ApplicationController:
- Whitelist allowed fields for update() with proper types/limits
- Validate commit SHA format (7-40 hex chars) on deploy
- Validate env var keys (uppercase, underscores only, starts with letter)
- Validate env var values (max 65535 chars)
- Add boolean flags validation for env vars

DatabaseController:
- Whitelist allowed fields for update()
- Validate backup frequency (cron format regex)
- Validate retention amounts (1-1000)
- Validate S3 storage UUID

Tests:
- Add 7 new validation tests
- Test invalid env var key format
- Test required env var fields
- Test invalid commit SHA format
- Test health check port/interval ranges

All 220 tests passing.

Stu Mason + AI <me@stumason.dev>

Author: StuMason

README.md

@@ -1,6 +1,26 @@
 # Laravel Coolify
 
-Deploy Laravel to [Coolify](https://coolify.io) with one command. Dashboard, CLI, and Dockerfile generation included.
+[![CI](https://github.com/StuMason/laravel-coolify/actions/workflows/ci.yml/badge.svg)](https://github.com/StuMason/laravel-coolify/actions/workflows/ci.yml)
+[![Latest Version](https://img.shields.io/packagist/v/stumason/laravel-coolify.svg)](https://packagist.org/packages/stumason/laravel-coolify)
+[![PHP Version](https://img.shields.io/packagist/php-v/stumason/laravel-coolify.svg)](https://packagist.org/packages/stumason/laravel-coolify)
+[![Laravel Version](https://img.shields.io/badge/laravel-11.x%20|%2012.x-red.svg)](https://laravel.com)
+[![License](https://img.shields.io/packagist/l/stumason/laravel-coolify.svg)](LICENSE)
+[![Downloads](https://img.shields.io/packagist/dt/stumason/laravel-coolify.svg)](https://packagist.org/packages/stumason/laravel-coolify)
+
+**Deploy Laravel to [Coolify](https://coolify.io) with one command. Dashboard, CLI, and Dockerfile generation included.**
+
+Like Laravel Horizon for queues, but for your entire infrastructure.
+
+![Laravel Coolify Dashboard](docs/dashboard.png)
+
+## Why This Exists
+
+Self-hosting with Coolify is great, but managing deployments from the Coolify UI gets tedious. This package gives you:
+
+- **A beautiful dashboard** inside your Laravel app - deploy, restart, view logs, manage env vars
+- **Artisan commands** for everything - CI/CD pipelines, local development, scripting
+- **Production-ready Dockerfiles** generated automatically - no Docker knowledge required
+- **Full API access** to Coolify - build custom tooling, automations, whatever you need
 
 ## Quick Start
 
@@ -16,30 +36,170 @@ COOLIFY_URL=https://your-coolify.com
 COOLIFY_TOKEN=your-api-token
 ```
 
-Then:
+Then provision your infrastructure:
 
 ```bash
 php artisan coolify:provision
 ```
 
-Creates app + PostgreSQL + Dragonfly on Coolify and deploys.
+Creates app + PostgreSQL + Dragonfly on Coolify and deploys. One command.
 
 ## Documentation
 
-**[Read the docs](https://stumason.github.io/laravel-coolify)**
+**[Read the full docs](https://stumason.github.io/laravel-coolify)**
+
+## Dashboard Features
+
+Access at `/coolify` (configurable) - works like Horizon's dashboard.
+
+| Feature | Description |
+|---------|-------------|
+| **Live Status** | Real-time application health with animated indicators |
+| **One-Click Deploy** | Deploy latest, force rebuild, or deploy specific commits |
+| **Deployment History** | View all deployments with inline expandable build logs |
+| **Database Management** | Start/stop/restart PostgreSQL, MySQL, Redis, Dragonfly |
+| **Environment Variables** | Secure CRUD for env vars with masked values |
+| **Build Logs** | Stream deployment logs in real-time |
+| **GitHub Integration** | Links to commits, branches, repository |
+| **Coolify Deep Links** | Jump directly to resources in Coolify UI |
+
+### Dashboard Screenshots
+
+The dashboard shows everything at a glance:
+
+- Application status with health checks
+- Current branch, commit, and last deploy time
+- Database and cache status with connection strings
+- Recent deployments with inline build logs
+- Quick actions for deploy, restart, stop
 
-## Commands
+## Artisan Commands
 
 | Command | Description |
 |---------|-------------|
 | `coolify:install` | Publish config, generate Dockerfile |
 | `coolify:provision` | Create infrastructure on Coolify |
 | `coolify:deploy` | Trigger deployment |
 | `coolify:status` | Show application status |
-| `coolify:logs` | View logs |
+| `coolify:logs` | View application logs |
 | `coolify:restart` | Restart application |
-| `coolify:rollback` | Rollback deployment |
+| `coolify:rollback` | Rollback to previous deployment |
+
+### CI/CD Integration
+
+```yaml
+# .github/workflows/deploy.yml
+- name: Deploy to Coolify
+  run: php artisan coolify:deploy --force
+  env:
+    COOLIFY_URL: ${{ secrets.COOLIFY_URL }}
+    COOLIFY_TOKEN: ${{ secrets.COOLIFY_TOKEN }}
+```
+
+## Dockerfile Generation
+
+The install command generates production-optimized Docker configuration:
+
+```bash
+php artisan coolify:install
+```
+
+Creates:
+- `Dockerfile` - Multi-stage build with OPcache, proper permissions
+- `docker/nginx.conf` - Optimized for Laravel
+- `docker/supervisord.conf` - Process management (Horizon, Reverb, Scheduler auto-detected)
+- `docker/php.ini` - Production PHP settings
+
+Auto-detects and configures:
+- Laravel Horizon (queue workers)
+- Laravel Reverb (WebSockets)
+- Laravel Scheduler
+
+## Programmatic API
+
+```php
+use Stumason\Coolify\Coolify;
+
+// Deploy
+Coolify::deploy();
+Coolify::deploy('custom-uuid');
+
+// Status
+$status = Coolify::status();
+$logs = Coolify::logs();
+
+// Repositories for full control
+Coolify::applications()->get($uuid);
+Coolify::applications()->deploy($uuid, force: true);
+Coolify::applications()->restart($uuid);
+Coolify::applications()->envs($uuid);
+
+Coolify::databases()->all();
+Coolify::databases()->start($uuid);
+
+Coolify::deployments()->forApplication($uuid);
+Coolify::deployments()->cancel($uuid);
+
+Coolify::servers()->all();
+Coolify::services()->all();
+```
+
+## Configuration
+
+```php
+// config/coolify.php
+return [
+    'url' => env('COOLIFY_URL'),
+    'token' => env('COOLIFY_TOKEN'),
+    'path' => env('COOLIFY_PATH', 'coolify'),  // Dashboard URL path
+
+    'docker' => [
+        'php_version' => '8.3',
+        'node_version' => '20',
+        'extensions' => ['pdo_pgsql', 'redis', 'pcntl', 'bcmath'],
+    ],
+];
+```
+
+## Authentication
+
+By default, the dashboard is only accessible in `local` environment. For production:
+
+```php
+// app/Providers/AppServiceProvider.php
+use Stumason\Coolify\Coolify;
+
+public function boot(): void
+{
+    Coolify::auth(function ($request) {
+        return $request->user()?->isAdmin();
+    });
+}
+```
+
+## Requirements
+
+- PHP 8.2+
+- Laravel 11 or 12
+- Coolify 4.x instance with API access
+
+## Testing
+
+```bash
+composer test          # Run tests
+composer test:coverage # With coverage
+composer lint          # Static analysis
+```
+
+## Contributing
+
+Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
 
 ## License
 
-MIT
+MIT - see [LICENSE](LICENSE)
+
+## Credits
+
+- [Stu Mason](https://github.com/StuMason)
+- [All Contributors](../../contributors)

dist/.gitkeep

@@ -1,29 +1,110 @@
 ---
 title: Dashboard Overview
-description: Coolify dashboard within Laravel
+description: A beautiful, feature-rich dashboard for managing your Coolify infrastructure
 ---
 
+The Laravel Coolify dashboard gives you complete control over your infrastructure from within your Laravel application. Think of it like Laravel Horizon, but for your entire deployment pipeline.
+
+![Dashboard Screenshot](/dashboard.png)
+
 ## Access
 
 Default route: `/coolify`
 
-Configurable via `COOLIFY_PATH` environment variable.
+Configurable via `COOLIFY_PATH` environment variable or in `config/coolify.php`.
 
 ## Features
 
-The dashboard shows:
-- Application status and health
-- Recent deployments with status
-- Database connection status
-- Redis/Dragonfly status
-- Quick actions (deploy, restart, view logs)
+### Hero Status Card
+
+The main dashboard shows your application's current state at a glance:
+
+- **Animated status indicator** - Pulsing green dot when running, red when stopped
+- **Build pack info** - Shows if using Dockerfile, Nixpacks, etc.
+- **Server info** - Which Coolify server hosts your app
+- **Quick links** - Direct links to your site, GitHub repo, and Coolify UI
+
+### Deployment Info Bar
+
+Essential deployment information always visible:
+
+| Field | Description |
+|-------|-------------|
+| **Branch** | Current Git branch with link to GitHub |
+| **Current Commit** | Short SHA with GitHub link and copy button |
+| **Last Deploy** | Relative time since last deployment with duration |
+| **Project** | Coolify project and environment name |
+
+### One-Click Deployments
+
+The deploy button dropdown offers multiple options:
+
+- **Deploy Latest** - Deploy HEAD from your current branch
+- **Force Rebuild** - Full rebuild without Docker cache
+- **Deploy Specific Commit** - Enter any commit SHA to deploy
+- **Redeploy Previous** - Quick redeploy of recent commits
+
+### Database & Cache Cards
+
+Resource cards for your databases showing:
+
+- Status badge (Healthy/Stopped/etc.)
+- Database type and image version
+- Internal hostname for container networking
+- Public port if exposed
+- Start/Stop/Restart controls
+- Direct link to Coolify UI
+
+### Recent Deployments
+
+Full deployment history with:
+
+- **Status icons** - Visual indicators for finished/failed/in-progress
+- **Commit info** - SHA with GitHub links, commit messages
+- **Duration** - How long each deployment took
+- **Relative timestamps** - "26m ago", "2h ago", etc.
+- **Redeploy button** - One-click redeploy of any commit
+- **Inline logs** - Expandable build logs without leaving the page
+
+### Accordion Build Logs
+
+Click "Logs" on any deployment to expand inline logs:
+
+- **Lazy loading** - Logs fetched on demand, not upfront
+- **6-line preview** - See a summary without overwhelming detail
+- **"See more" expansion** - Expand to see all logs
+- **Color-coded output** - stdout vs stderr differentiated
+- **Line numbers** - Easy reference for debugging
+- **Link to full logs** - Jump to dedicated log viewer
+
+## Pages
+
+The dashboard includes multiple pages accessible from the sidebar:
+
+| Page | Description |
+|------|-------------|
+| **Dashboard** | Main overview with status, deployments, resources |
+| **Deployments** | Full deployment history with search and filters |
+| **Resources** | All databases and services in your environment |
+| **Configuration** | Environment variables, settings, backup schedules |
+| **Logs** | Real-time application logs |
+
+## Quick Actions
+
+The command palette (`Cmd/Ctrl + K`) provides quick access to:
+
+- Deploy application
+- Restart application
+- View logs
+- Navigate between pages
+- Stop/Start services
 
 ## Local-Only Access
 
-By default, the dashboard is only accessible when:
+By default, the dashboard is only accessible in local environment:
 
 ```php
 app()->environment('local')
 ```
 
-For production access, configure authentication.
+For production access, see [Authentication](/dashboard/authentication).