Mary UI Laravel Starter Kit

Project Overview

Mary UI Laravel Starter Kit is a comprehensive, production-ready foundation for building modern web applications. It combines the robustness of Laravel 12.x with the elegance of Mary UI and the reactivity of Livewire Volt, providing developers with everything they need to kickstart their next project.

Repository Stats

Packagist Version Packagist Downloads

Core Technologies

Backend: Laravel 12.x (PHP 8.2+)
Frontend Framework: Livewire 3.x with Volt
UI Components: Mary UI
Styling: Tailwind CSS 4.x + DaisyUI
Icons: Blade Hero and Font Awesome
Build Tool: Vite
Database: SQLite (default, easily switchable)
Testing: Pest framework
Code Quality: Pint, Rector

Authentication & User Management

Complete Auth System

Login, registration, and password reset flows
Email verification capabilities
User profile administration with avatar uploads
Session management

User Administration Dashboard

Comprehensive CRUD operations for user management
User status tracking (Active, Inactive, Suspended)
Advanced search and filtering
Bulk operations support

OAuth Integration

Google OAuth authentication built-in
Social account connection to existing profiles
Extensible provider architecture for adding more OAuth providers

Roles & Permissions

Flexible permission system
Role assignment and management
Guard-based permissions
Easy integration with your application logic

Developer Experience

Testing

80+ comprehensive tests using Pest framework
Unit, feature, and browser tests included
Pre-configured test database setup
Test coverage for critical user flows

Code Quality Tools

Pint: Laravel’s opinionated PHP code formatter
Rector: Automated code refactoring and upgrades
LaraDumps: Enhanced debugging and profiling
Laravel Pail: Real-time log tailing in the terminal

Development Workflow

Quick setup with one command:

laravel new my-app --using=lauroguedes/mary-ui-starter-kit

Or clone and install:

composer install
npm install
php artisan migrate --seed

Start development with hot reload:

composer dev

This launches the development server, queue worker, log monitor, and Vite with hot module replacement - all concurrently!

Production Ready

Optimized asset bundling with Vite
Database migrations and seeders included
Email templates with Mailpit for local testing
Environment-based configuration
Security best practices implemented out of the box

Perfect For

SaaS applications requiring rapid development
Internal business tools and dashboards
Client projects with tight deadlines
Learning Laravel best practices and modern patterns
Prototyping and MVPs

Open Source

This project is open source under the MIT License and welcomes contributions from the community. Visit the GitHub repository to report issues, suggest features, or contribute code.

Tech Stack