Download the PHP package lauroguedes/mary-ui-starter-kit without Composer

Mary UI Starter Kit 🚀

✨ Features

🎨 Frontend Stack

• Livewire 3.x with Volt for reactive single-file components
• Mary UI 2.x - Beautiful, accessible UI components
• Tailwind CSS 4.x + DaisyUI for styling
• Blade Hero and Fontawesome icons integration
• Vite for lightning-fast asset bundling

🔐 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

• 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

🏗️ 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

• Complete test coverage for authentication flows
• User management CRUD operations testing
• Roles and Permissions management CRUD operations testing
• File upload and avatar management testing
• Form validation and error handling
• Database cleanup and file storage testing

📁 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

Prerequisites

• PHP 8.2+
• Node.js 18+
• Composer
• SQLite (included with PHP)

Installation

Clone the repository manually:

Development Workflow

For an enhanced development experience with hot reloading:

Visit http://localhost:8000 to view your application.

This runs:

• Laravel development server
• Queue worker
• Log monitoring (Pail)
• Vite dev server with hot reload

🧪 Testing

Run the comprehensive test suite:

🔧 Customization

Key environment variables for customization. Change the APP_LAYOUT to sidebar or header and LOGIN_LAYOUT to card, simple, or split:

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

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

We maintain high code quality standards:

📋 Roadmap

• [x] Role-based permissions system ✅
• [ ] Advanced Log and Audit
• [ ] Multi-tenant support
• [ ] Advanced notification system
• [ ] Dashboard analytics
• [ ] API integration with Laravel Sanctum

🆘 Support

• Documentation: Mary UI Docs
• Issues: GitHub Issues

📝 License

This project is open-sourced software licensed under the MIT license.