VersionTracker is a Laravel 12 application that centralizes software versions, releases, and security information. The project provides a modern Filament 4 admin panel (incl. Analytics Dashboard) as well as a public Vue frontend with timeline visualization.

• Filament Admin with approval workflow, Analytics Dashboard, and Audit Tools
• Release Timeline SPA (Vue 3 + Vite) including software filter
• Demo Data & User for an immediately populated showcase
• Tailwind v4 Design System with custom Filament theme

• PHP 8.3 · Laravel 12 · Livewire 3 · Filament 4
• MySQL/PostgreSQL/SQLite (Default: SQLite)
• Node 20+ · Vite · Vue 3 · Tailwind CSS 4

• PHP >= 8.3 + Composer 2.x
• Node.js >= 20 + npm 10
• SQLite (default) or an alternative database

1. Clone Repository

   git clone https://github.com/<your-org>/versiontracker.git
   cd versiontracker

2. Install Composer Dependencies

   composer install

3. Prepare Environment

   cp .env.example .env
   php artisan key:generate

   • For SQLite: touch database/database.sqlite and leave DB_CONNECTION=sqlite in .env.
   • For MySQL/Postgres: set appropriate DB_* variables.

4. Run Migrations & Seeders

   php artisan migrate --seed

   This generates demo data including users & releases.

5. Load Front-End Dependencies

   npm install
   npm run dev

   For production: npm run build.

6. Start Application

   php artisan serve

   App available at http://localhost:8000. The Filament panel is at /admin.

• Public Timeline SPA: /timeline
• API Endpoints: /api/public/* (e.g. /api/public/timeline)

• Code Style: vendor/bin/pint --dirty
• Tests: php artisan test
• Vite Dev Server: npm run dev
• Build: npm run build

• php artisan migrate --force
• npm run build + Deploy assets under public/build
• Adapt .env to production environment (APP_URL, DB, QUEUE_CONNECTION etc.)
• php artisan storage:link if not already done

MIT – see LICENSE.