PHPackages lauroguedes/mary-ui-starter-kit - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. lauroguedes/mary-ui-starter-kit ActiveProject[Framework](/categories/framework) lauroguedes/mary-ui-starter-kit =============================== A modern Laravel starter kit featuring Livewire Volt, Mary UI, and Tailwind CSS with complete authentication, user management, and comprehensive testing. v1.4.0(3mo ago)27172โ†“50%5[1 issues](https://github.com/lauroguedes/mary-ui-starter-kit/issues)MITPHPPHP ^8.3CI failing Since Jun 15Pushed 3mo ago3 watchersCompare [ Source](https://github.com/lauroguedes/mary-ui-starter-kit)[ Packagist](https://packagist.org/packages/lauroguedes/mary-ui-starter-kit)[ Docs](https://github.com/lauroguedes/mary-ui-starter-kit)[ RSS](/packages/lauroguedes-mary-ui-starter-kit/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (7)Dependencies (21)Versions (12)Used By (0) Mary UI Starter Kit ๐Ÿš€ ===================== [](#mary-ui-starter-kit-) A **modern, production-ready Laravel starter kit** featuring **Livewire 4** and **Mary UI**. Build beautiful web applications with a complete authentication system, user management, and developer-friendly tooling. [![Laravel](https://camo.githubusercontent.com/f6297199551c8dac7133b87d594461c2e625dbc21818cf39f70b2ce2623afe64/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d7265643f7374796c653d666c6174266c6f676f3d6c61726176656c)](https://laravel.com)[![Livewire](https://camo.githubusercontent.com/34a6f0a4f414bfc74f5bfccd2b53cefd2da82a6a6724696473d209da2db64a94/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c697665776972652d342e782d707572706c653f7374796c653d666c6174)](https://livewire.laravel.com)[![Mary UI](https://camo.githubusercontent.com/a709ba5ce1220b03231cac86c45b4eb7b6a58eb72c1e26ef83e9b35400ea95d3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6172795f55492d322e782d626c75653f7374796c653d666c6174)](https://mary-ui.com)[![License](https://camo.githubusercontent.com/0ead21b67127a8f9d0549de3701c8673cc63d8c7c7e54ca0814f25584e524dee/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e3f7374796c653d666c6174)](LICENSE) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ [](#) [![Packagist Version](https://camo.githubusercontent.com/73442beb78222ac94407a276f5a46ced783874c5f12954f39fce67a850cda73a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6175726f6775656465732f6d6172792d75692d737461727465722d6b69743f7374796c653d666c6174)](https://packagist.org/packages/lauroguedes/mary-ui-starter-kit)[![Packagist Downloads](https://camo.githubusercontent.com/ca28e98e531191f1505e330dd380fb2809661c56fe62d8c46fc7936bf0f0e6d5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6175726f6775656465732f6d6172792d75692d737461727465722d6b69743f7374796c653d666c6174)](https://packagist.org/packages/lauroguedes/mary-ui-starter-kit)[![Laravel Forge Site Deployment Status](https://camo.githubusercontent.com/668157f228a7b3ecd1e51223e4e53d72b053286f329aaa043a9adfbde34bd65e/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f75726c3d6874747073253341253246253246666f7267652e6c61726176656c2e636f6d253246736974652d62616467657325324639363537626430392d386337632d343231392d616230312d626130376636363739633861267374796c653d666c6174)](https://forge.laravel.com/lauro-guedes-q58/graceful-silence-fzg/3022898) [![demo_screenshot](https://private-user-images.githubusercontent.com/3677780/455287455-6005b127-2d3f-4c7e-a4fc-2dfc257faafb.jpeg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzM5MDAzMzIsIm5iZiI6MTc3MzkwMDAzMiwicGF0aCI6Ii8zNjc3NzgwLzQ1NTI4NzQ1NS02MDA1YjEyNy0yZDNmLTRjN2UtYTRmYy0yZGZjMjU3ZmFhZmIuanBlZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzE5VDA2MDAzMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTIzZWM0NzFiYTUzY2ZmNzU4OTZiNTkyOWRkYTk4NzFiMTMzYmVjMzQ1ODBiNDgxNDRmYWY5OTZhNmYwMzMzOGUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.ETEfm0mdU8JuMPmXt1gdzogBAc0dfYq3R6DYezJIuiw)](https://private-user-images.githubusercontent.com/3677780/455287455-6005b127-2d3f-4c7e-a4fc-2dfc257faafb.jpeg?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzM5MDAzMzIsIm5iZiI6MTc3MzkwMDAzMiwicGF0aCI6Ii8zNjc3NzgwLzQ1NTI4NzQ1NS02MDA1YjEyNy0yZDNmLTRjN2UtYTRmYy0yZGZjMjU3ZmFhZmIuanBlZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMTklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzE5VDA2MDAzMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTIzZWM0NzFiYTUzY2ZmNzU4OTZiNTkyOWRkYTk4NzFiMTMzYmVjMzQ1ODBiNDgxNDRmYWY5OTZhNmYwMzMzOGUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.ETEfm0mdU8JuMPmXt1gdzogBAc0dfYq3R6DYezJIuiw) โœจ Features ---------- [](#-features) ### ๐ŸŽจ **Frontend Stack** [](#-frontend-stack) - **Livewire 4.x** for reactive components with improved performance - **Mary UI 2.x** - Beautiful, accessible UI components - **Tailwind CSS 4.x** + **DaisyUI v5** for styling - **Blade Hero and Fontawesome** icons integration - **Vite** for lightning-fast asset bundling ### ๐Ÿ” **Authentication & User Management** [](#-authentication--user-management) - Complete authentication system (login, registration, password reset) - Email verification with resend functionality - Password confirmation for sensitive operations - User profile management with avatar uploads - **User management dashboard** with full CRUD operations - **User status management** (Active, Inactive, Suspended) - **Advanced filtering and search** capabilities - **Avatar management** with automatic cleanup - **Google OAuth integration** for social login - **Roles & Permissions system** powered by Spatie Laravel Permission - **Role-based access control** with granular permission management - **User role assignment** and permission checking middleware ### ๐Ÿ”— **OAuth Socialite Integration** [](#-oauth-socialite-integration) - **Laravel Socialite** integration with extensible provider system - **Google OAuth** authentication out of the box - **Social account linking** to existing user accounts - **Automatic user creation** for new social logins - **Extensible architecture** for adding new OAuth providers - **Secure token handling** and user data synchronization ### ๐ŸŽญ **Demo Mode** [](#-demo-mode) - **Built-in demo mode** for showcasing your application - **Scheduled data reset** to maintain clean demo environment - **Configurable demo password** or auto-generated random password on each reset - **Login protection** prevents password changes in demo mode - **Visual indicator** alerts users when demo mode is active - **Configurable reset schedule** (hourly, daily, etc.) ### ๐Ÿ—๏ธ **Architecture & Developer Experience** [](#๏ธ-architecture--developer-experience) - **Laravel 12.x** with PHP 8.2+ support - **SQLite** database by default (easy local setup) - **Pest testing framework** with 80+ comprehensive tests - **Code quality tools**: Pint (formatting), Rector (refactoring) - **Debugging tools**: LaraDumps, Laravel Pail - **Development workflow** with Concurrently for multi-process dev server - **OAuth Socialite Integration** with extensible architecture for new oauth providers ### ๐Ÿงช **Testing Coverage** [](#-testing-coverage) - Complete test coverage for authentication flows - User management CRUD operations testing - Roles and Permissions management CRUD operations testing - Demo mode functionality testing - File upload and avatar management testing - Form validation and error handling - Database cleanup and file storage testing ### ๐Ÿ“ **File Management** [](#-file-management) - Avatar upload with cropping support (Cropper.js) - Automatic file cleanup on user deletion - File validation (type, size) - Storage testing with fake disks ๐Ÿš€ Quick Start ------------- [](#-quick-start) ### Prerequisites [](#prerequisites) - **PHP 8.2+** - **Node.js 18+** - **Composer** - **SQLite** (included with PHP) ### Installation [](#installation) ``` # Install via Laravel Installer laravel new my-app --using=lauroguedes/mary-ui-starter-kit # or Composer composer create-project lauroguedes/mary-ui-starter-kit my-app # (Optional) Generate fake data for testing php artisan db:seed # Default user user: test@user.com pw: secret ``` Clone the repository manually: ``` # Clone the repository git clone https://github.com/lauroguedes/mary-ui-starter-kit cd mary-ui-starter-kit # Install PHP dependencies composer install # Copy environment file and generate app key cp .env.example .env php artisan key:generate # Set up the database php artisan migrate --seed # Install frontend dependencies npm install # or if you use Yarn yarn # Run the development server php artisan serve # In a separate terminal npm run dev # or yarn dev ``` ### Development Workflow [](#development-workflow) For an enhanced development experience with hot reloading: ``` # Start all development services (server, queue, logs, vite) composer dev ``` Visit to view your application. This runs: - Laravel development server - Queue worker - Log monitoring (Pail) - Vite dev server with hot reload ๐Ÿงช Testing --------- [](#-testing) Run the comprehensive test suite: ``` # Run all tests ./vendor/bin/pest # Run with coverage ./vendor/bin/pest --coverage ``` ๐Ÿ”ง Customization --------------- [](#-customization) Key environment variables for customization: ``` # Appearance settings APP_LAYOUT=sidebar # Options: sidebar, header LOGIN_LAYOUT=card # Options: card, simple, split # Demo mode settings DEMO_MODE=false # Enable demo mode for showcasing the app DEMO_PASSWORD= # Fixed password for all demo users (random if not set) DEMO_RESET_SCHEDULE=hourly # Options: hourly, daily, weekly ``` ๐Ÿค Contributing -------------- [](#-contributing) We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details. ### Development Setup [](#development-setup) 1. Fork the repository 2. Create a feature branch: `git checkout -b feature/amazing-feature` 3. Make your changes and add tests 4. Run the test suite: `./vendor/bin/pest` 5. Commit your changes: `git commit -m 'Add amazing feature'` 6. Push to the branch: `git push origin feature/amazing-feature` 7. Open a Pull Request ### Code Quality [](#code-quality) We maintain high code quality standards: ``` # Format code ./vendor/bin/pint # Refactor code ./vendor/bin/rector # Run tests ./vendor/bin/pest ``` ๐Ÿ“‹ Roadmap --------- [](#-roadmap) - **Role-based permissions system** โœ… - **Demo mode for showcasing** โœ… - **Advanced Log and Audit** - **Multi-tenant support** - **Advanced notification system** - **Dashboard analytics** - **API integration with Laravel Sanctum** ๐Ÿ†˜ Support --------- [](#-support) - **Documentation**: [Mary UI Docs](https://mary-ui.com) - **Issues**: [GitHub Issues](https://github.com/lauroguedes/mary-ui-starter-kit/issues) ๐Ÿ“ License --------- [](#-license) This project is open-sourced software licensed under the [MIT license](LICENSE). --- **Built with โค๏ธ by [Lauro Guedes](https://lauroguedes.dev)** **โญ Star this repository if it helped you!** ### Health Score 47 โ€” FairBetter than 94% of packages Maintenance80 Actively maintained with recent releases Popularity25 Limited adoption so far Community11 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~38 days Recently: every ~57 days Total 7 Last Release 103d ago PHP version history (2 changes)v1.0.0PHP ^8.2 v1.3.0PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/b18e02804e8def009ab7f6085416e7dd30afbfbf219e1fd4d0ac8b059ec80fdf?d=identicon)[lauroguedes](/maintainers/lauroguedes) --- Top Contributors [![lauroguedes](https://avatars.githubusercontent.com/u/3677780?v=4)](https://github.com/lauroguedes "lauroguedes (130 commits)") --- Tags daisyuilaravellivewiremaryuiphpphpframeworklaravelAuthenticationlivewiretailwindvoltUser managementstarter-kitmary-uipest-testing ### Code Quality TestsPest Static AnalysisRector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/lauroguedes-mary-ui-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/lauroguedes-mary-ui-starter-kit/health.svg)](https://phpackages.com/packages/lauroguedes-mary-ui-starter-kit) ``` ### Alternatives [nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[codewithdennis/larament Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow. 3691.5k](/packages/codewithdennis-larament)[raugadh/fila-starter Laravel Filament Starter. 614.9k](/packages/raugadh-fila-starter) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)