README

A modern, production-ready starter kit combining the power of Laravel, Inertia.js, Vue 3, and TailwindCSS

What is VILT? • Why Choose VILT? • Features • Installation

What is VILT?

VILT (Laravel + Inertia + Vue + TailwindCSS) is a carefully crafted starter kit that brings together the most powerful modern web development tools. Skip the tedious setup and jump straight into building amazing applications with a battle-tested foundation.

Why Choose VILT?

🏗️ Production Ready - Pre-configured with best practices and modern tooling
🚀 Developer Experience - Hot reloading, TypeScript support, and modern dev tools
🔒 Enterprise Grade - Built-in error tracking, code quality tools, and testing setup
📱 Modern UI - TailwindCSS 4.x with responsive design patterns
⚡ Performance First - Optimized builds, SSR support, and efficient bundling

Features

Frontend Stack

Feature	Version	Description
Vue 3	`3.5.x`	Composition API with `<script setup>` syntax
Inertia.js	`2.x`	SPA experience without API complexity
TailwindCSS	`4.x`	Utility-first CSS framework
Vite	`7.x`	Lightning-fast build tool and dev server
SSR Support	✅	Server-side rendering for better SEO

Backend Stack

Feature	Version	Description
Laravel	`12.x`	Modern PHP framework with latest features
PHP	`8.4+`	Latest PHP with performance improvements
Ziggy	`2.x`	Use Laravel routes in JavaScript
Sentry	`4.x`	Error tracking and performance monitoring

Development Tools

Tool	Purpose
ESLint	JavaScript/Vue linting with auto-fix
Prettier	Code formatting for consistent style
Laravel Pint	PHP code style fixer
Larastan	Static analysis for Laravel
Rector	Automated code upgrades and refactoring
Pest PHP	Modern testing framework
Husky	Git hooks for code quality

Installation

Quick Start (Recommended)

laravel new my-awesome-app --using=devuni/vilt-starter-kit

Clone & Setup

# Clone the repository
git clone https://github.com/devuni-cz/vilt-starter-kit.git my-project
cd my-project

# Install dependencies
composer install && npm install

# Setup environment
cp .env.example .env
php artisan key:generate
php artisan migrate

# Start development
composer dev

Your development environment is ready at http://localhost:8000 🎉

Local Development

Essential Commands

# Start all services
composer dev

# Individual services
php artisan serve               # Laravel server
npm run dev                     # Vite dev server
php artisan queue:listen        # Queue worker

# Code quality
npm run format                  # Auto-fix all code
npm run lint                    # Check frontend
composer analyse                # PHP analysis

# Database
php artisan migrate             # Run migrations
php artisan migrate:fresh --seed # Fresh DB with data

Project Structure

├── app/                    # Laravel application
├── resources/js/
│   ├── components/         # Vue components
│   ├── layouts/           # Page layouts
│   ├── pages/             # Inertia pages
│   └── utils/             # JavaScript utilities
├── routes/                # Application routes
└── tests/                 # Test files

Production

Building for Production

# Build frontend assets
npm run build

# Build with SSR support
npm run build:ssr

# Optimize Laravel
php artisan config:cache
php artisan route:cache
php artisan view:cache

SSR Server Setup

For production SSR, run the Inertia SSR server with Supervisor (recommended):

Create /etc/supervisor/conf.d/inertia-ssr.conf:

[program:inertia-ssr]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/artisan inertia:start-ssr
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/var/www/html/storage/logs/inertia.log

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start inertia-ssr:*

Sentry Configuration

The project includes Sentry for error tracking. Configure these environment variables:

# Sentry Configuration
SENTRY_LARAVEL_DSN=your-sentry-dsn-here
SENTRY_TRACES_SAMPLE_RATE=1
SENTRY_AUTH_TOKEN=your-auth-token

# Frontend Sentry (automatically passed from Laravel)
VITE_SENTRY_DSN="${SENTRY_LARAVEL_DSN}"

Sentry is pre-configured in vite.config.js with:

Source maps for production debugging
Release tracking for deployment monitoring
Error reporting for both frontend and backend

To customize Sentry settings, update the sentryVitePlugin configuration in vite.config.js.

Contributing

We welcome contributions! See our Contributing Guidelines.

Fork the repository
Create feature branch: git checkout -b feature/amazing-feature
Make changes and test: npm run format && composer test
Commit: git commit -m 'feat: add amazing feature'
Push and create Pull Request

License

Licensed under the MIT license.

Made with ❤️ by Devuni

⭐ If this helped you, please give it a star! ⭐

🐛 Report Bug • 💡 Request Feature

devuni / vilt-starter-kit

Maintainers

Details