laravel-vue-starter

# Laravel Vue Starter

An opinionated Laravel 13 + Vue 3 starter template for building modern admin panels and SPA applications. Ships with authentication, authorization, user management, and a polished UI — so you can skip the boilerplate and start building.

## Stack

| Layer | Technology |
|-------|-----------|
| **Backend** | Laravel 13, PHP 8.3+ |
| **Frontend** | Vue 3 (Composition API), Pinia 3, Vue Router 5 |
| **UI** | DaisyUI 5, Tailwind CSS 4, Heroicons |
| **Auth** | Laravel Sanctum (cookie-based SPA), Laravel Fortify |
| **Authorization** | Bouncer (roles & abilities) |
| **Media** | Spatie Media Library (avatar uploads with conversions) |
| **Build** | Vite 8 |

## Features

- **Authentication** — Login, register, forgot/reset password, email verification
- **Authorization** — Role-based access control with Bouncer (admin/regular roles)
- **User Management** — Full CRUD with sidebar drawer, filters, sorting, pagination
- **Dark Mode** — Light/dark theme toggle, persisted in localStorage
- **Collapsible Sidebar** — With tooltips when collapsed, persisted state
- **Toast Notifications** — System-wide success/error/info/warning toasts
- **Localization** — i18n support (English + Macedonian included)
- **Profile Page** — Tabbed settings (general, password, avatar) with cover header
- **Component Library** — Buttons, inputs, tables, modals, badges, spinners, file upload, dropdowns
- **Components Showcase** — Built-in page at `/panel/components` demonstrating all UI components

## Quick Start

```bash
git clone https://github.com/gdarko/laravel-vue-starter.git
cd laravel-vue-starter
composer install
cp .env.example .env
php artisan key:generate
npm install
php artisan migrate --seed
```

Start the development servers:

```bash
# Terminal 1
php artisan serve

# Terminal 2
npm run dev
```

Open `http://localhost:8000` and login with:
- **Email:** [email protected]
- **Password:** 123123

## CORS / Domain Setup

For Sanctum SPA auth to work, update `.env`:

```env