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

Backend Stack

Development Tools

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.

1. Fork the repository
2. Create feature branch: git checkout -b feature/amazing-feature
3. Make changes and test: npm run format && composer test
4. Commit: git commit -m 'feat: add amazing feature'
5. 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